日付/時刻文

日付、時刻、またはタイムスタンプとして文字列をフォーマットします。

Synopsis

{d 'yyyy-mm-dd'}
{t 'hh:mm:ss'}
{ts 'yyyy-mm-dd hh:mm:ss.fff'}

概要

この文は ODBC 日付形式の文字列を受け取り、それを対応する $HOROLOG 内部日付、時刻、またはタイムスタンプに変換します。この文は、データ形式の決定と、値および範囲のチェックを行います。

これらの関数にタイムスタンプ文字列を指定すると、以下のように処理されます。

{d 'string'} 日付文は、時刻コンポーネントを無視します。これは日付コンポーネントを検証および表示します。検証に失敗した日付値は、内部値のゼロ (0) に設定されます。日付値の表示時、この 0 は '12/31/1840' として表示されます。
{t 'string'} 時刻文は、日付/時刻文字列が指定されると、処理に失敗し、すべてゼロの値 (00:00:00) を返します。時刻文字列が指定されると、時刻値を検証および表示します。その際、小数秒は切り捨てられます (丸めるのではなく)。検証に失敗した時刻値は、内部値のゼロ (0) に設定され、00:00:00 として表示されます。
{ts 'string'} タイムスタンプ文は、日付/時刻文字列をフォーマットして返します。これには小数秒を含めることもできます。日付文字列のみが指定されると、その日付値を検証および表示し、時刻はゼロ値 (00:00:00) を返します。時刻値または無効な日付値が指定されると、指定された文字列をそのまま返します。

詳細は、"Caché ObjectScript リファレンス" の "$HOROLOG" 特殊変数を参照してください。

例

以下の例は、これらの日付/時刻文を使用して、4 つの値を検証および表示します。LeapDate フィールドでは検証に成功し、'02/29/2004' として表示されます。NonLeapDate の値はうるう年検証に失敗するため有効値とならず、そのフィールドは既定でゼロ値になります。このゼロ日付は、'12/31/1840' として表示されます。TimeStamp 文は検証を行い、TSGoodDate の完全なタイムスタンプを ODBC タイムスタンプ形式で '2003–02–28 00:00:00' として返します。TimeStamp 文は、検証に失敗すると、指定された文字列のリテラルを返します。TSBadDate の表示値は '2003–02–29' です。

SELECT DISTINCT {d '2004-02-29'} AS LeapDate,
{d '2003-02-29'} AS NonLeapDate,
{ts '2003-02-28'} AS TSGoodDate,
{ts '2003-02-29'} AS TSBadDate
FROM Sample.Person