Text to Date
テキスト文字列の内容から、指定した書式の日時を作成します。
ほとんどの標準的な形式では、この関数は必要ありません。標準的な任意の日時テキストを日付入力に渡せば、自動的に変換されます。この関数は標準以外の、または不明瞭な形式、たとえば2/1という値が、2月1日と1月2日のどちらにも読めるような場合に使用します。
入力
フィールド | 定義 | タイプ | 必須 |
---|---|---|---|
start |
日時値に変換するテキスト。 |
テキスト |
TRUE |
format |
startフィールドの入力値の日時書式コード。 |
テキスト |
FALSE |
出力
フィールド | 定義 | タイプ |
---|---|---|
output |
指定した書式コードに基づいた、startの入力値に対応するデータオブジェクト。 |
日時 |
書式コード
必要な日時書式を作成します。これらのコードと、スラッシュやカンマなどの固定文字の組み合わせを使用します。
書式コード | 出力 |
---|---|
D |
1か月の中の日付。日付を常に2桁で表示するには、DDを指定します。 |
M |
単一の月番号。2桁で表示するには、MMを指定します。 |
MMM |
月名の3文字の略称。完全な月名で表示するには、MMMMを指定します。 |
Y |
4桁の年番号。年番号を2桁で表示するには、YYを指定します。 |
h |
時間番号(1~12)、時間番号を2桁で表示するには、hhを指定します。 |
H |
時間番号(0~23)、時間番号を2桁で表示するには、HHを指定します。 |
mm |
分番号。 |
ss |
秒番号。ミリ秒を含めるときは.Sを追加します(例:ss.SSS)。 |
a |
am/pmの指定。AM/PMで表示するには、Aを指定します。 |
Z |
オフセット形式のタイムゾーン(例:-07:00)。zを指定することで、PDTなどのコードを表示することもできます。 |
d |
曜日(月曜日が 1)。Monなどの曜日の省略表記を表示するには、dddを指定します。Mondayなどの曜日の完全名を表示するには、ddddを指定します。 |
x |
「ミリ秒単位のUNIX」形式のタイムスタンプ。これは、1970年1月1日午前0時以降のミリ秒単位のカウントとして定義されます。 |
X |
「秒単位のUNIX」形式のタイムスタンプは、「epoch」または「UNIXタイムスタンプ」とも呼ばれます。これは、1970年1月1日午前0時以降の秒単位のカウントとして定義されます。 |
例
start | format | output |
---|---|---|
1/2/2016 |
D/M/Y |
2016-02-01T00:00:00.000Z |
1/2/16 |
M/D/YY |
2016-01-02T00:00:00.000Z |
1493053116 |
X |
2017-04-24T16:58:36.000Z |