日付および時刻フォーマット文字列
フォーマット文字列は、文字列から日付、時刻、または日付時刻値、および日付､時刻、または日付時刻値から文字列への変換のテンプレートとして使用されます。以下のトークンは、フォーマット文字列 fmt で解釈され、StringToDate や StringToDateTime などの文字列の日付、時刻、または日付時刻値の部分を読み込むために使用します。
日付フォーマット
| トークン | 値 |
|---|---|
| yyyy | 4 桁の年 (2012 など) |
| yy | 2 桁の年 (12 など) |
| MMMM | 完全な月の名前 (January など) |
| MMM | 省略形の月の名前 (Jan など) |
| mm 1 | 2 桁の月 (必要に応じて数字の前にゼロを入れます)01 月 = 1、12 月 = 12 |
| m | 1 桁または 2 桁の月 (数字の前にゼロを入れません)1 月 = 1、12 月 = 12 |
| dddd | 完全な曜日の名前 (Tuesday など) |
| ddd | 省略形の曜日の名前 (Tues など) |
| dd | 2 桁の日 (必要に応じて数字の前にゼロを入れます)。(04 など) |
| d | 1 桁または 2 桁の日 (数字の前にゼロを入れません)。(4 など) |
DateToString を呼び出すとき、フォーマット文字列 fmt には、結果として返される文字列にそのまま引き渡される他のトークンや文字が含まれる場合があります。
日付フォーマット文字列の使用例
引数 date の値として 2003 年 10 月 7 日火曜日という日付が設定されている場合の、以下の DateToString の呼び出しの結果をそれぞれ示します。
DateToString(date, 'mm-dd-yy') : 10-07-03
DateToString(date, 'm-d-yyyy') : 10-7-2003
DateToString(date, 'dddd, mmmm d, yyyy') : Tuesday, October 7, 2003
DateToString(date, 'Today is dddd') : Today is Tuesday
以下の StringToDate の呼び出しはすべて、2003 年 10 月 7 日を表す Date 値を生成します。
StringToDate('10/7/2003', 'm/d/yyyy')
StringToDate('10-07-03', 'm-dd-yy')
StringToDate('Today is 2003-Oct-03', 'Today is yyyy-mmm-dd')
時刻フォーマット
| トークン | 値 |
|---|---|
| hh | 2 桁の時間 (09 など) |
| mm 1 | 2 桁の分 (59 など) |
| ss | 2 桁の秒 (05 など) |
| tt | AM または PM (PM など)。A または P には 1 文字の t を使用します。 |
| fff | 最大 3 位までの秒の小数部分 (ミリ秒)。4 桁以降は切り捨てられます。 |
日付および時刻の書式設定は必ず小文字で指定してください。例えば、時間を表すには HH ではなく hh を使用します。
式の中で DateTime 列や Time 列を単独で使用する場合は、現在のロケールを使用してフォーマットされます。
式の中に DateTime 列や Time 列が含まれる場合、その文字列値は TimeToNumber または DateToNumber + スペース + TimetoNumber になります。
時刻および日付時刻フォーマット文字列の使用例
引数 time の値として 午前 10 時 50 分 30 秒という時刻が設定されている場合の、以下の TimeToString および StringToTime の呼び出しの結果をそれぞれ示します。
TimeToString(time, 'hh:mm:ss tt') : 10:50:30 AM
TimeToString(time, 'The time is hh:mm:ss tt') : The time is 10:50:30 AM.
TimeToString(time, 'hh:mm:ss.fff tt") : 10:50:30.333 AM
StringToTime('10:50:30 AM', 'hh:mm:ss tt')
StringToTime('The time is 10:50:30 AM', 'The time is hh:mm:ss tt')
StringToTime('10:50:30.333 AM', 'hh:mm"ss.fff tt")
以下の例は、2012 年 7 月 6 日 午前 10 時 50 分 30 秒という日付および時刻を、文字列および日付時刻に変換します。
StringToDateTime('07/06/2012 10:50:30 AM', 'mm/dd/yyyy hh:mm:ss tt')
DateTimeToString(StringToDateTime('07-06-2012 10:50:30 AM', 'mm-dd-yyyy hh:mm:ss tt'), 'mm-dd-yyyy hh:mm:ss tt')