翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
日時形式の文字列
以下の一般的なシナリオでは、日時パターンを使用できます。
-
CSV および JSON データソースを使用して日時コンテンツを解析およびフォーマットする場合
-
次のような関数を使用して文字列型と日付型またはタイムスタンプ型の間で変換する場合:
-
unix_timestamp
-
date_format
-
to_unix_timestamp
-
from_unixtime
-
to_date
-
to_timestamp
-
from_utc_timestamp
-
to_utc_timestamp
-
日付とタイムスタンプの解析と書式設定には、次の表のパターン文字を使用します。
日付部分または時刻部分 | 意味 | 例 |
---|---|---|
a | 当日の午前 または午後、午前 - 午後として表示 | PM |
D | 3 桁の数字で表示される曜日 |
189 |
d | 2 桁の数字で表示される日付 | 28 |
E | テキストとして表示される曜日 |
火 火曜日 |
F | 1 桁の数字で表示される、その月の曜日の一致 | 3 |
G | テキストとして表示される Era インジケータ |
AD アンノ・ドミニ |
h | 午前または午後の時刻。2 桁の数字で表示 | 12 |
H | 0~23 の 2 桁の数字で表示される時刻 | 0 |
k | 1~24 の 2 桁の数字で表示される時刻 | 1 |
K | 0~11 の 2 桁の数字で表示される午前または午後の時間 | 0 |
m | 2 桁の数字で表示される分 | 30 |
M/L | 月として表示される年月 |
7 07 7 月 7 月 |
O | UTC からのローカライズゾーンオフセット |
GMT+8 GMT+8:00 UTC-08:00 |
Q/Q | 数値 (1 ~ 4) またはテキストで表示される、年四半期 |
3 03 Q3 第 3 四半期 |
s | 2 桁の数字で表示される分単位の秒 | 55 |
S | 分数として表示される 1 秒の分数 | 978 |
V | zone-id として表示されるタイムゾーン識別子 |
America/Los_Angeles Z 08:30 |
x | UTC からのゾーンオフセット (offset-X) |
+0000 -08 -0830 -08:30 -083015 -08:30:15 |
X | UTC からのゾーンオフセット。Z はゼロの場合 |
Z -08 -0830 -08:30 -083015 -08:30:15 |
y | 年、年として表示 |
2020 20 |
z | タイムゾーン名、テキストで表示 |
太平洋標準時 PST |
Z | UTC からのゾーンオフセット (offset-Z) |
+0000 -0800 -08:00 |
' | 区切り文字として表示されるテキストのエスケープ | 該当なし |
'' | リテラルとして表示される一重引用符 | ' |
[ | オプションのセクション開始 | 該当なし |
] | オプションのセクション終了 | 該当なし |
パターン文字の数によって形式タイプが決まります。
テキスト形式
-
省略形には 1~3 文字を使用します (月曜日には「月」など)。
-
完全な形式 (「月曜日」など) には 4 文字のみを使用してください。
-
5 文字以上は使用しないでください。エラーが発生します。
数値形式 (n)
-
値 n は、許可される文字の最大数を表します。
-
単一文字パターンの場合:
-
出力はパディングなしで最小桁数を使用します
-
-
複数の文字パターンの場合:
-
出力は文字数の幅に合わせてゼロで埋められます
-
-
解析する場合、入力には正確な桁数が含まれている必要があります
数値/テキスト形式
-
3 文字以上の場合は、テキスト形式ルールに従います。
-
文字数を減らすには、数値形式ルールに従います。
フラクション形式
-
1~9 個の「S」文字を使用する (SSSSSS など)
-
解析の場合:
-
1 から S 文字数までの小数を受け入れる
-
-
フォーマットの場合:
-
S 文字数と一致するゼロのパッド
-
-
マイクロ秒の精度で最大 6 桁をサポート
-
ナノ秒を解析できますが、余分な桁は切り捨てます
年形式
-
文字数は、パディングの最小フィールド幅を設定します。
-
2 文字の場合:
-
最後の 2 桁を出力します
-
2000-2099 の間の年を解析する
-
-
4 文字未満の場合 (2 文字を除く):
-
負の年のみの符号を表示します
-
-
7 文字以上は使用しないでください。エラーが発生します。
月の形式
-
標準フォームには「M」、スタンドアロンフォームには「L」を使用します。
-
単一の「M」または「L」:
-
パディングなしで月番号 1~12 を表示します
-
-
「MM」または「LL」:
-
パディング付きの月番号 01~12 を表示します
-
-
'MMM':
-
略名を標準形式で表示する
-
完全な日付パターンの一部である必要があります
-
-
'LLL':
-
省略された月名をスタンドアロン形式で表示する
-
月のみの書式設定に使用
-
-
「MMMM」:
-
月名を標準形式で表示する
-
日付とタイムスタンプに を使用する
-
-
'LLLL':
-
完全な月名をスタンドアロン形式で表示する
-
月のみの書式設定に使用
-
タイムゾーン形式
-
am-pm: 1 文字のみを使用する
-
ゾーン ID (V): 2 文字のみを使用する
-
ゾーン名 (z):
-
1~3 文字: 短縮名を表示します
-
4 文字: フルネームを表示します
-
5 文字以上は使用しないでください
-
オフセット形式
-
X と x:
-
1 文字: 時間 (+01) または時間/分 (+0130) を表示
-
2 文字: コロンなしの時間/分を表示 (+0130)
-
3 文字: コロンで時間/分を表示 (+01:30)
-
4 文字: コロンなしhour-minute-secondを表示 (+013015)
-
5 文字: hour-minute-secondとコロン (+01:30:15) を表示
-
X はゼロオフセットに「Z」を使用します
-
x はゼロオフセットに「+00」、「+0000」、または「+00:00」を使用します
-
-
O:
-
1 文字: 短縮形 (GMT+8) を表示
-
4 文字: フルフォームを表示 (GMT+08:00)
-
-
Z:
-
1~3 文字: コロンなしで時間/分を表示 (+0130)
-
4 文字: 完全なローカライズされたフォームを表示します
-
5 文字: コロンでhour-minute-secondを表示
-
オプションセクション
-
角括弧 [ ] を使用してオプションのコンテンツをマークする
-
オプションのセクションをネストできます
-
すべての有効なデータが出力に表示されます
-
入力はオプションセクション全体を省略できます
注記
記号「E」、「F」、「q」、「Q」は、日時形式 (date_format など) でのみ機能します。日時解析 (to_timestamp など) には使用しないでください。