日付と時間のフォーマット
アプリケーション、プラットフォーム、またはインターフェースの要件に従って、4Dプロジェクトにおける日付や時間の表示形式を管理しなくてはならない場合があります。
4Dには、デフォルトの形式に加えて、カスタマイズされた日付と時間のフォーマットを作成および適用するために使用できる包括的なパターンのリストが含まれています。 カスタマイズされたフォーマットパターンは、以下の機能でサポートされています:
StringコマンドOBJECT SET FORMATおよびOBJECT Get formatコマンド- プロパティリストまたは
dateFormatおよびtimeFormatのJSONプロパティから利用可能な、フォームオブジェクトの "日付/時間フォーマット" プロパティ
パターンリスト
以下の表は、日付/時間フォーマットでサポートされているすべてのパターンの一覧です (一部の出力はローカライズされており、システムパラメーターに依存します)。
| 記号 | 意味 | パターン | 出力例 |
|---|---|---|---|
| G | 元号 | G, GG, GGG | 西暦 |
| GGGG | 西暦 | ||
| GGGGG | A | ||
| y | 年 | yy | 96 |
| y または yyyy | 1996 | ||
| Y | ウィークカレンダーの年 | Y | 1997 |
| u | 拡張年 | u | 4601 |
| Q | 四半期 | Q | 2 |
| 02 | |||
| QQQ | Q2 | ||
| QQQQ | 第2四半期 | ||
| QQQQQ | 2 | ||
| q | 四半期 (単独) | q | 2 |
| 02 | |||
| qqq | Q2 | ||
| qqqq | 第2四半期 | ||
| qqqqq | 2 | ||
| M | 月 | M | 9 |
| MM | 09 | ||
| MMM | 9月 | ||
| MMMM | 9月 | ||
| MMMMM | 9 | ||
| L | 月 (単独) | L | 9 |
| LL | 09 | ||
| LLL | 9月 | ||
| LLLL | 9月 | ||
| LLLLL | 9 | ||
| w | 週番号 | w | 27 |
| ww | 27 | ||
| d | 日 | d | 2 |
| dd | 2 | ||
| D | 日 (年始からの日数) | D | 189 |
| E | 曜日 | E, EE, EEE | 火 |
| EEEE | 火曜日 | ||
| EEEEE | 火 | ||
| EEEEEE | 火 | ||
| e | ローカル曜日 | e | 3 |
| ee | 03 | ||
| eee | 火 | ||
| eeee | 火曜日 | ||
| eeeee | 火 | ||
| eeeeee | 火 | ||
| c | ローカル曜日 (単独) | c, cc | 3 |
| ccc | 火 | ||
| cccc | 火曜日 | ||
| ccccc | 火 | ||
| cccccc | 火 | ||
| a | 午前、午後 | a, aa, aaa | 午後 |
| aaaa | 午後 | ||
| aaaaa | 午後 | ||
| b | 午前、午後、正午 | b, bb, bbb | 正午 |
| bbbb | 正午 | ||
| bbbbb | 正午 | ||
| B | 時間帯表現 | B, BB, BBB | 夜 |
| BBBB | 夜 | ||
| BBBBB | 夜 | ||
| h | 時間 (1~12) | h | 7 |
| hh | 07 | ||
| H | 時間 (0~23) | H | 0 |
| HH | 00 | ||
| K | 時間 (0~11) | K | 0 |
| KK | 00 | ||
| k | 時間 (1~24) | k | 24 |
| kk | 24 | ||
| m | 分 | m | 4 |
| mm | 04 | ||
| s | 秒 | s | 5 |
| ss | 05 | ||
| ○ | タイムゾーン: ISO8601 基本 hm? 0 の場合は Z 表示 | ○ | -08, +0530, Z |
| タイムゾーン: ISO8601 基本 hm, 0 の場合は Z 表示 | XX | -0800, Z | |
| タイムゾーン: ISO8601 拡張 hm, 0 の場合は Z 表示 | XXX | -08:00, Z | |
| タイムゾーン: ISO8601 基本 hms?, 0 の場合は Z 表示 | XXXX | -0800, -075258, Z | |
| タイムゾーン: ISO8601 拡張 hms?, 0 の場合は Z 表示 | XXXXX | -08:00, -07:52:58, Z | |
| x | タイムゾーン: ISO8601 基本 hm?, Z 表示なし | x | -08, +0530, +00 |
| タイムゾーン: ISO8601 基本 hm, Z 表示なし | xx | -0800, +0000 | |
| タイムゾーン: ISO8601 拡張 hm, Z 表示なし | xxx | -08:00, +00:00 | |
| タイムゾーン: ISO8601 基本 hms?, Z 表示なし | xxxx | -0800, -075258, +0000 | |
| タイムゾーン: ISO8601 拡張 hms?, Z 表示なし | xxxxx | -08:00, -07:52:58, +00:00 | |
| O | タイムゾーン: 短いローカライズされた GMT | O | GMT+9 |
| タイムゾーン: 長いローカライズされた GMT (=ZZZZ) | OOOO | GMT+09:00 | |
| z | タイムゾーン: 共通形式 | z, zz, zzz | JST |
| zzzz | 日本標準時 | ||
| zzzzz | 日本標準時 | ||
| ' | テキスト用エスケープ | ' | ' |
| ' ' | 2つの一重引用符は 1つの一重引用符として解釈されます | ' ' | ' ' |
パターンについて
y vs Y
y は暦年、Y は週番号に基づく年です。 たとえば、2010年の1月の最初の日が週番号1ではない場合、y = 2010 かつ Y = 2009 となりえます (2010年の最初の週が始まる日まで)。(週番号の数え方にはいくつかの方式があります)
L (単独) vs M
ロシア語、スロバキア語など一部の言語では、単独で使用される月名と日付内の月名が異なります。 たとえば、"2010年1月10日" と "1月の約束" の "1月" が同じ綴りで表現されません。
e vs c
L と M の場合と同様に、c は単独で使用される曜日 ("毎週火曜日") に使用するのに対し、e は日付内の曜日 ("1951年1月15日火曜日") に使われます。
E vs e
e はシステムの設定に基づいています。もし週が水曜日から始まるとシステムで定義されている場合、水曜日は数値の "1" (または "0") を持つことになりますが、E は常に同じ値を返します (1〜7 または 0〜6)。
先頭のゼロ
一般的に、フォーマット文字列の文字数が数値の桁数よりも多い場合、先頭にゼロが追加されます。 例: "yyyyyy" は "001996" と表示されます。
ローカライズされた出力
一部の出力 ("正午"、"火曜日" など) は、地域設定に応じてローカライズされます。
たとえば、時間 13:25:34 の場合、米国のシステムでは in the afternoon、フランスのシステムでは après-midi、日本のシステムでは 昼 と表示されます。
追加の文字
フォーマット文字列には、フォーマット文字として解釈されない文字を含めることができます。追加の文字が "a" から "z" または "A" から "Z" の間の文字の場合、それらは一重引用符で囲む必要があります。
例:
"15:30:00" をパターン "HH 'hours and' mm 'minutes'" で表現すると、"15 hours and 30 minutes" と出力されます。
先頭と末尾のスペース
パターンの先頭と末尾のスペースは、出力の際に自動でトリミングされます。 結果の文字列の先頭や末尾にスペースを入れるには、一重引用符で囲む必要があります。
例:
" HH : mm : ss " ---> "09 : 10 : 25"
"' 'HH : mm : ss' '" ---> " 09 : 10 : 25 "
例題
| 日付/時間 | パターン | 戻り値 | コメント |
|---|---|---|---|
| 2000/06/15 | "QQQQ" | "第2四半期" | ローカライズ済み |
| 2001/03/17 | "D" | "76" | 年始から 76日目 |
| 1954/03/17 | "w" | "12" | 年の 12週目 |
| 1954/03/17 | "eeee" | "水曜日" | ローカライズ済み |
| 15:00:00 | "a" | "午後" | |
| 18:00:00 | "a K" | "午後 6" | |
| 13:30:15 | "aa hh:mm O" | "午後 01:30 GMT+9" |
参照
カスタムの日付と時刻のフォーマットに関する詳細については、このブログ記事 を参照ください。