datetime_to_string関数は、項目参照の値または日時リテラルを日時型とみなし、指定された変換書式で変換した文字列を返却します。指定するデータは、標準日時形式である必要があります。
datetime_to_string関数の書式を以下の図に示します。
図4.19 datetime_to_string関数の書式
日時変換書式は、以下の文字列とセパレータ文字を使用して、任意の順番で指定できます。書式要素は、1つ以上指定してください。
カテゴリ | 書式要素 | 変換後の長さ | 変換後の範囲 | 備考 |
|---|---|---|---|---|
年 | YY | 2文字(固定) | 00～99 | 西暦の下2桁が出力されます。 |
YYYY | 4文字(固定) | 0001～9999 | ||
月 | MM | 2文字(固定) | 01～12 | |
M | 可変 | 1～12 | 先頭に0を付加しません。 | |
MONTH | 可変 | JANUARY,FEBRUARY,MARCH,APRIL,MAY, | ||
Month | 可変 | January,February,March,April,May, | ||
MON | 3文字(固定) | JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG, | ||
Mon | 3文字(固定) | Jan,Feb,Mar,Apr,May,Jun,Jul,Aug, | ||
日 | DD | 2文字(固定) | 01～31 | |
D | 可変 | 1～31 | 先頭に0を付加しません | |
曜日 | DAY | 可変 | SUNDAY,MONDAY,TUESDAY,WEDNESDAY, | 年月日から自動的に設定されます。 |
Day | 可変 | Sunday,Monday,Tuesday,Wednesday, | 年月日から自動的に設定されます。 | |
DY | 3文字(固定) | SUN,MON,TUE,WED,THU,FRI,SAT | 年月日から自動的に設定されます。 | |
Dy | 3文字(固定) | Sun,Mon,Tue,Wed,Thu,Fri,Sat | 年月日から自動的に設定されます。 | |
時 | hh | 2文字(固定) | 00～23 | |
h | 可変 | 0～23 | 先頭に0を付加しません。 | |
分 | mm | 2文字(固定) | 00～59 | |
m | 可変 | 0～59 | 先頭に0を付加しません。 | |
秒 | ss | 2文字(固定) | 00～59 | |
s | 可変 | 0～59 | 先頭に0を付加しません。 |
名称 | 文字 |
|---|---|
半角空白 | |
コロン | ： |
ピリオド | . |
カンマ | , |
スラッシュ | / |
ハイフン | - |
セパレータ文字指定無し |
注意
セパレータ文字以外で、同じカテゴリの書式要素を複数指定できません。（例:YY-YY-MM）
セパレータ文字を連続して指定できません。(例:YY--MM--DD)
セパレータ文字を、先頭または末尾に指定できません。(例:-YY-MM-DD)
セパレータ文字だけを指定することはできません。(例:///)
曜日は、グレゴリオ暦(1582/10/15～)を基に算出されます。それ以前から使用されていたユリウス暦の範囲では、正確な曜日となりません。
参照
項目参照については、“3.1.9 項目参照”を参照してください。
日時リテラルについては、“3.1.6 リテラル”を参照してください。
変換が正常に動作した場合は、文字列型を返します。項目参照の値が空の場合は空を返します。
$出勤日時が“2010-04-01 08:30:45”の場合
datetime_to_string($出勤日時, "YY/MM/DD hh:mm")
文字列として、“10/04/01 08:30”を出力します。
