CTOD( ) 関数

文字または数値の日付値を日付に変換します。また、文字または数値の日付時刻値から日付を抽出し、それを日付として返すこともできます。"Character to Date" の省略形です。

構文

CTOD(文字/数値 <,書式>)

パラメーター

名前	種類	説明
文字/数値	文字 数値	日付に変換する、あるいは日付を抽出するフィールド、式、またはリテラル値。
書式 省略可能	文字	文字/数値を日付書式にした値。YYYYMMDD または YYMMDD を除く日付書式を使用した値を指定する場合には、書式が必須です。書式の例："DD/MM/YYYY" メモ 書式パラメーターを必要とする日付時刻値で CTOD 関数を使用する場合は、書式の日付部分のみを指定してください。時刻部分を指定してはいけません。例： CTODT("31/12/2014 23:59:59", "DD/MM/YYYY hh:mm:ss") 時刻部分を指定すると、結果が表示されなくなります。

出力

日付時刻。日付値は、現在 Analytics に設定されている日付の表示書式を使用して出力されます。

例

基本的な例

文字リテラルの入力値

`20141231` に対して現在の Analytics 日付表示書式である DD MMM YYYY を適用した、31 Dec 2014 が返されます。

CTOD("20141231")

CTOD("31/12/2014", "DD/MM/YYYY")

CTOD("20141231 235959")

数値リテラルの入力値

`20141231` に対して現在の Analytics 日付表示書式である DD MMM YYYY を適用した、31 Dec 2014 が返されます。

CTOD(20141231)

CTOD(31122014, "DDMMYYYY")

CTOD(20141231.235959)

フィールドへの文字型入力値

指定した文字フィールドの各値が現在の Analytics 日付表示形式を使用した日付として返されます。

CTOD(Invoice_date, "DD/MM/YYYY")

CTOD(Receipt_timestamp)

フィールドへの数値型入力値

指定した数値フィールドの各値が現在の Analytics 日付表示形式を使用した日付として返されます。

CTOD(Due_date, "DDMMYYYY")

CTOD(Payment_timestamp)

高度な例

備考

必須の日付書式

日付値または日付時刻値を含んでいる文字フィールドおよび数値フィールドは、次の表内の書式と一致している必要があります。日付時刻値は、そのデータ型に有効な日付、区切り文字、および時刻の書式を任意に組み合わせて使用することができます。日付を時刻の前に置く必要があり、かつ、2 つの間に区切り文字を入れる必要があります。

日付、または日付時刻値の日付部分は、Analytics でサポートされており、そのデータ型に有効であれば、どのような日付書式でも使用することができます。ただし、YYYYMMDD と YYMMDD 以外の書式は、書式で正しく定義されてさえいれば使用できます。

日付書式	区切り文字形式	時刻書式
文字フィールド
YYYYMMDD	単一の空白スペース	hhmmss hh:mm:ss
YYMMDD	文字 't'	hhmm hh:mm
書式で定義されている場合は、データ型に有効な、Analytics がサポートする任意の日付書式	文字 'T'	hh
		+/-hhmm +/-hh:mm （UTC オフセット）
		+/-hh （UTC オフセット）
		メモ UTC オフセットが設定されているデータのメインの時刻書式で hh を単独で使用しないでください。たとえば、「hh+hhmm」という使い方は避けてください。信頼できない結果になる可能性があります。）
数値フィールド
YYYYMMDD	小数点	hhmmss
YYMMDD		hhmm
書式で定義されている場合は、データ型に有効な、Analytics がサポートする任意の日付書式		hh

他の日付時刻変換関数

文字または数値から日付時刻への変換

関数	説明
CTODT( )	文字または数値の日付時刻値を日付時刻に変換します。"Character to Datetime" の省略形です。
CTOT( )	文字または数値の時刻値を時刻に変換します。また、文字または数値の日付時刻値から時刻を抽出し、それを時刻として返すこともできます。"Character to Time" の省略形です。

日付時刻から文字への変換

関数	説明
DATE( )	指定された日付または日付時刻から日付を抽出し、それを文字データとして返します。また、現在のオペレーティング システム日付を返すこともできます。
DATETIME( )	日付時刻を文字列に変換します。また、現在のオペレーティング システムの日付時刻を返すこともできます。
TIME( )	指定された時刻または日付時刻から時刻を抽出し、それを文字データとして返します。また、現在のオペレーティング システムの時刻を返すこともできます。

シリアルから日付時刻への変換

関数	説明
STOD( )	シリアル日付、つまり、整数で表される日付を日付値に変換します。"Serial to Date" の省略形です。
STODT( )	シリアル日付時刻、つまり、整数部分と 24 時間の小数部分で表される日付時刻を日付時刻値に変換します。"Serial to Datetime" の省略形です。
STOT( )	シリアル時刻、つまり、24 時間を 1 として、24 時間が小数部分で表される時刻を時刻値に変換します。"Serial to Time" の省略形です。