StrToDateStd
任意フォーマットの日時文字列からDateTime型の日時データを生成します。
■入力／出力
接続数: 1
| 入力 | データ型 | 説明 |
| 入力1 | String | 文字列表現での日時 |
| 出力 | データ型 | 説明 |
| 出力1 | DateTime | 文字列から生成した日時データ |
■プロパティ
| 名前 | プロパティ型 | 説明 |
| 変換方法 | choice | 入力文字列がメールヘッダ形式のフォーマットか、自分でフォーマットを指定するかを指定します。
| プロパティ指定 [Custom]
| - | 日付フォーマット、タイムゾーン、ロケールを自分で指定して入力文字列を解析します。
|
| メールヘッダー形式 [MailFormat]
| - |
RFC2822で定義されたDateフィールドのフォーマットで入力文字列を解析します。
|
|
| 日付フォーマット | choice |
入力の日付フォーマットを指定します。
既定のフォーマット以外に、直接入力してフォーマットを指定できます。複数のフォーマットを指定した場合は、変換できるまで上から順に適用されます。フォーマットについては、下記トピック「日付フォーマットの記述方法」を参照してください。
| 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)]
| - |
システムのデフォルトタイムゾーンを使用します。
|
| (GMT) [(GMT)]
| - |
グリニッジ標準時を使用します。
|
|
| ロケール | choice | ロケールを指定します。
| システムのロケール [(default)]
| - |
システムのデフォルトロケールを使用します。
|
|
| 和暦を使用する | boolean | ロケールで指定されたロケールの言語が「ja」である場合に、和暦を使用するかどうかを指定します。
| はい [true]
| - | 和暦を使用します
|
| いいえ [false]
| - | 西暦を使用します
|
|
| 変換できない場合の動作 | choice | 入力文字列が日付フォーマットの形式に変換できなかった場合の動作を指定します。
| 1970/01/01 [1970/01/01]
| - |
1970/01/01(日付の最小値)を出力します。
|
| Nullを出力 [Null]
| - |
nullを出力します。
|
| 入力をそのまま出力 [Input]
| - |
入力値をそのまま出力します。
|
| エラーを発生 [Exception]
| - |
エラーを発生します。
|
|
日付フォーマットはJavaのSimpleDateFormatで使用される日時パターンを使用します。
詳細につきましてはSimpleDateFormatのヘルプをご覧ください。
以下にパターン文字列の表を抜粋して記載します。
| 記号 | 意味 | 例 |
| G | 西暦の場合は紀元、和暦の場合は元号(令和、平成など) | AD、令和 |
| y | 年 | 2023 |
| M | 月 | 07 |
| d | 日 | 10 |
| h | 午前／午後の時（1～12） | 11 |
| H | 一日における時（0～23） | 24 |
| m | 分 | 45 |
| s | 秒 | 54 |
| S | ミリ秒 | 955 |
| E | 曜日 | 火 |
| D | 年における日 | 145 |
| F | 月における曜日 | 2 (第２水曜) |
| w | 年における週 | 24 |
| W | 月における週 | 2 |
| a | 午前／午後 | PM |
| k | 一日における時（1～24） | 24 |
| K | 午前／午後の時（0～11） | 0 |
| z | 一般的なタイムゾーン | JST |
| Z | RFC 822タイムゾーン | -0800 |
| X | ISO 8601タイムゾーン | -08; -0800; -08:00 |
| ' | テキスト用エスケープ |
|
| '' | 単一引用符 | ' |
- 元号のパターン文字の数が何個でも漢字2文字の元号として解釈されます。また、令和を表すRのようなアルファベット1文字の元号には対応していません。
- 元号の場合、年のパターン文字は漢数字には対応していません。
-
１つの日付フォーマットで西暦と和暦の両方を解釈することはできません。
-
構文にz/Z(タイムゾーン)が使われていない場合、タイムゾーンで指定したタイムゾーンでの日時として解釈します。z/Z(タイムゾーン)が使われている場合、タイムゾーンは無視されます。
■例
| プロパティ | 出力 |
| 入力1 | 2003/04/01 | 日付フォーマット | yyyy/MM/dd | 2003-04-01T00:00:00.000 |
| | ロケール | システムのロケール | |
| | 和暦を使用する | いいえ | |
| プロパティ | 出力 |
| 入力1 | H300927 | 日付フォーマット | GyyMMdd | 2018-09-27T00:00:00.000 |
| | ロケール | システムのロケール | |
| | 和暦を使用する | はい | |
| プロパティ | 出力 |
| 入力1 | 平成30年09月27日 | 日付フォーマット | GGyy年MM月dd日 | 2018-09-27T00:00:00.000 |
| | ロケール | システムのロケール | |
| | 和暦を使用する | はい | |