StrToDate
任意フォーマットの日時文字列からDateTime型の日時データを生成します。
■入力/出力
接続数: 1
入力 | データ型 | 説明 |
入力1 | String | 文字列表現での日時 |
出力 | データ型 | 説明 |
出力1 | DateTime | 文字列から生成した日時データ |
■プロパティ
名前 | プロパティ型 | 説明 |
変換方法 | choice | 入力文字列がメールヘッダ形式のフォーマットか、自分でフォーマットを指定するかを指定します。
プロパティ指定 [Custom]
| - | 日付フォーマット、タイムゾーン、ロケールを自分で指定して入力文字列を解析します。
|
メールヘッダー形式 [MailFormat]
| - |
RFC2822で定義されたDateフィールドのフォーマットで入力文字列を解析します。
|
|
日付フォーマット | choice |
入力の日付フォーマットを指定します。
既定のフォーマット以外に、直接入力してフォーマットを指定できます。フォーマットについては、下記トピック「日付フォーマットの記述方法」を参照してください。本関数では3桁の元号年には対応していません。
yyyy/MM/dd HH:mm:ss | - | 例:2006/09/27 16:36:44
|
yyyy/MM/dd hh:mm:ss | - | 例:2006/09/27 04:36:44
|
yyyy/MM/dd | - | 例:2006/09/27
|
|
ロケール | choice | ロケールを指定します。
システムのロケール [(default)]
| - |
システムのデフォルトロケールを使用します。
|
|
タイムゾーン | choice | タイムゾーンを指定します。
システムのタイムゾーン [(default)]
| - |
システムのデフォルトタイムゾーンを使用します。
|
(GMT) [(GMT)]
| - |
グリニッジ標準時を使用します。
|
|
変換できない場合の動作 | choice | 入力文字列が日付フォーマットの形式に変換できなかった場合の動作を指定します。
1970/01/01 [1970/01/01]
| - |
1970/01/01(日付の最小値)を出力します。
|
Nullを出力 [Null]
| - |
nullを出力します。
|
入力をそのまま出力 [Input]
| - |
入力値をそのまま出力します。
|
エラーを発生 [Exception]
| - |
エラーを発生します。
|
|
以下の記号の組み合わせで記述します。
記号 | 意味 | 例 |
g | 元号(平成、昭和など) | 平成 |
e | 元号に対応した年 | 18 |
G | 年号 | AD |
y | 年 | 2003 |
M | 月 | 07 |
d | 日 | 10 |
h | 午前/午後の時(1~12) | 11 |
H | 一日における時(0~23) | 0 |
m | 分 | 45 |
s | 秒 | 54 |
S | ミリ秒 | 955 |
E | 曜日 | 火 |
D | 年における日 | 145 |
F | 月における曜日 | 2 (第2水曜) |
w | 年における週 | 24 |
W | 月における週 | 2 |
a | 午前/午後 | PM |
k | 一日における時(1~24) | 24 |
K | 午前/午後の時(0~11) | 0 |
z | タイムゾーン | 一般的なタイムゾーン |
' | テキスト用エスケープ |
|
'' | 単一引用符 | ' |
- 元号のパターン文字の数が1の場合英字1文字の元号になり、2の場合漢字1文字の元号になり、3以上の場合漢字2文字の元号になります。例えば平成の場合にはそれぞれ、'H'、'平'、'平成'となります。
- 元号年のパターン文字の数が3以下の場合は通常通り最小桁数になりますが、4以上の場合は1年の時には'元'の1文字になりその他の年は3を引いた最小桁数となります。
- 元号年のパターン文字は漢数字には対応していません。
- 構文にz(タイムゾーン)が使われていない場合、タイムゾーンで指定したタイムゾーンでの日時として解釈します。z(タイムゾーン)が使われている場合、タイムゾーンは無視されます。
- フォーマット構文はSimpleDateFormatクラスを参照してください。
■例
| プロパティ | 出力 |
入力1 | 2003/04/01 | 日付フォーマット | yyyy/MM/dd | 2003-04-01T00:00:00.000 |
| | ロケール | システムのロケール | |
| | タイムゾーン | システムのロケール | |
| プロパティ | 出力 |
入力1 | H190927 | 日付フォーマット | geeMMdd | 2007-09-27T00:00:00.000 |
| | ロケール | システムのロケール | |
| | タイムゾーン | システムのロケール | |
| プロパティ | 出力 |
入力1 | 平成元年09月27日 | 日付フォーマット | gggeeeee年MM月dd日 | 1989-09-27T00:00:00.000 |
| | ロケール | システムのロケール | |
| | タイムゾーン | システムのロケール | |
| プロパティ | 出力 |
入力1 | 平成19年09月27日 | 日付フォーマット | gggee年MM月dd日 | 2007-09-27T00:00:00.000 |
| | ロケール | システムのロケール | |
| | タイムゾーン | システムのロケール | |