説明
パラメータ
- $bytes整数(その文字列)を指定。
- $decimals小数点以下の桁数を指定(省略時は0)。
返り値
パラメータ$bytesを1000桁毎にグループ化してサイズフォーマットした文字列を返す。パラメータ$bytesの数値の大きさによって、返される文字列は変わる。$bytesは0以下の場合はfalseを返す。| 数値 | 単位表記 | 定数 |
|---|---|---|
| YB | 1,208,925,819,614,629,174,706,176(1024^8) | YB_IN_BYTES |
| ZB | 1,180,591,620,717,411,303,424(1024^7) | ZB_IN_BYTES |
| EB | 1,152,921,504,606,846,976(1024^6) | EB_IN_BYTES |
| PB | 1,125,899,906,842,624(1024^5) | PB_IN_BYTES |
| TB | 1,099,511,627,776(1024^4) | TB_IN_BYTES |
| GB | 1,073,741,824(1024^3) | GB_IN_BYTES |
| MB | 1,048,576(1024^2) | MB_IN_BYTES |
| KB | 1,024(1024^1) | KB_IN_BYTES |
| B | 1 |
注意
単位は、数値の大きい順、すなわち'TB'、'GB'、'MB'の順に適用される。なお、1024以上1,048,576未満のキロバイト表記は'KB'ではなく'kB'になる(現在は'KB'に変更済み)。
[6.0.0]'PB'(ペタバイト)、'EB'(エクサバイト)、'ZB'(ゼタバイト)、'YB'(ヨタバイト)が追加される。これらのような大きな数値の場合、パラメータ$bytesは文字列で指定することになる。
使用例
- 小数点以下がないサイズフォーマット済みの数値を取得する。<?php $formatted = size_format( $size ); ?>
- 小数点以下1桁のサイズフォーマット済みの数値を取得する。<?php $formatted = size_format( $size, 1 ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/functions.php最終更新 : 2022年05月31日 10:06
関連
お勧め
カテゴリー専用の投稿一覧と新規投稿メニューを追加する(2012年1月23日 更新)
サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。ブロックエディターの文字サイズ設定を変えてみる(2019年12月12日 更新)
今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。
4.2で始まるiOSの絵文字ケア(2018年5月27日 更新)
WordPress 4.2のベータ1、ベータ2が立て続けにリリースされ、4.2の正式版リリースが近づいています。4.2のポイントの1つは絵文字のクロスブラウザ対応です。ここでの絵文字とは、UTF-8で4バイトのコードが割り当てられている(基本的にはiOSの)絵文字を指します。この絵文字を含んだ投稿が正しく保存できなかったり、iOS以外の環境で意図した通りに表示できないといった問題があり、4.2ではそのような問題を対処をコードが組み込まれています。
「不明な書式」って何ですか。(2024年11月13日 更新)
オートコンプリート機能を利用して四字熟語を挿入するプラグインを作った際、ツールバーに「不明な書式をクリア(Clear Unknown Formatting)」ボタンが表示されるようになった。この「書式」、何を指しているのかわからないんだが。
決まった値を返すだけの関数群(2018年5月27日 更新)
WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。