FORMAT_DATE関数
関数
FORMAT_DATE{[FORMAT]}
指定された日付フォーマットにしたがって、対象文字列を変換します。
対象文字列が空文字または空白文字(タブおよび改行を含む)のみの場合、データ加工の開始実行日時に変換します。
対象文字列が日付文字列でない場合はエラーとなります。
FORMAT_DATE関数で日付フォーマットとして読み込み可能な日付文字列については、「DataMagic 操作マニュアル」の日付タイプの説明を参照してください。
パラメータ
FORMAT
日付フォーマットを指定します(省略可)。
指定する書式は、日付フォーマットと同一です。
省略すると、"YYYY/MM/DD"が設定されます。
入出力の関係
入力データの項目タイプと出力データの項目タイプの関係を以下の表に示します。
入力 |
出力 |
---|---|
X |
M |
N |
M |
M |
M |
D |
M |
W |
M |
9(数字文字列) |
M |
I |
エラー |
出力フォーマットの一覧を以下の表に示します。
# |
文字列 |
説明 |
---|---|---|
1 |
YYYY |
西暦年(4桁) |
2 |
YY |
西暦年(下2桁) ただし、2000年代とみなされます。 例:YYの部分が18の場合、2018年。 |
3 |
EYY |
元号の省略形+和暦年(00~99)(T09、S25など) |
4 |
EEYY |
元号+和暦年(00~99)(大正09、昭和25など) |
5 |
eyy |
元号の省略形+和暦年(0~99)(T9、S25など) |
6 |
eeyy |
元号+和暦年(0~99)(大正9、昭和25など) |
7 |
MM |
月(01~12) |
8 |
mm |
月(1~12) |
9 |
DD |
日(01~31) |
10 |
dd |
日(1~31) |
11 |
HHまたはHH24 |
時間(00~23) |
12 |
hhまたはhh24 |
時間(0~23) |
13 |
HH12 |
時間(01~12) |
14 |
hh12 |
時間(1~12) |
15 |
MI |
分(00~59) |
16 |
mi |
分(0~59) |
17 |
SS |
秒(00~59) |
18 |
ss |
秒(0~59) |
19 |
MON |
月の英語表記の省略形(すべて大文字)(JANなど) |
20 |
Mon |
月の英語表記の省略形(先頭のみ大文字)(Janなど) |
21 |
mon |
月の英語表記の省略形(すべて小文字)(janなど) |
22 |
MONTH |
月の英語表記(すべて大文字)(JANUARYなど) |
23 |
Month |
月の英語表記(先頭のみ大文字)(Januaryなど) |
24 |
month |
月の英語表記(すべて小文字)(januaryなど) |
25 |
AM |
AM:午前、またはPM:午後 |
26 |
Am |
Am:午前、またはPm:午後 |
27 |
am |
am:午前、またはpm:午後 |
28 |
A.M. |
A.M.:午前、またはP.M.:午後 |
29 |
a.m. |
a.m.:午前、またはp.m.:午後 |
-
繰り上がりの動作については、「DataMagic 操作マニュアル」にある、DataMagicの自動判定による日付データの読み込み処理の説明を参照してください。
-
区切り文字を指定する場合は、上記の表の文字列以外を使用できます。
-
平成より新しい元号に対応するには、システム動作環境設定ファイル(huledenv.conf)の「元号(era_name)」で新しい元号を設定する必要があります。
使用例
FORMAT_DATE関数の例を以下の表に示します。
入力 |
FORMAT_DATE関数の指定 |
結果 |
---|---|---|
20180430 |
FORMAT_DATE{YYYY/MM/DD} |
2018/04/30 |
20180430 |
FORMAT_DATE{} |
2018/04/30 |
20180430 |
FORMAT_DATE{MM/DD/YY} |
04/30/18 |