日付関数

関数一覧

AGE COUNT2DATE DATESTR DATESTR_JPN DAY
DAYCOUNT DAYOF DAY_ENG DAY_JPN ETO10
ETO10STR ETO12 ETO12STR ETOSTR ISDATE
ISLEAPYEAR MONTHOF TODAY YEAROF YEAR_JPN
ZODIAC ZODIAC_ENG ZODIAC_JPN

日付関数

日付を操作する関数。 多くの関数は文字列での日付表記、あるいは、数式での年、月、日の 二通りを引数と出来る。
日付の文字列表記は、元号表記、あるいは西暦表記が可能である。
日付が正常でないときの値は保証できない。 通常は数値ならばオーバーフロー値、文字列ならば空の文字列になる。

日付

DAYCOUNT

num DAYCOUNT( str 日付 )
num DAYCOUNT( num, num, num)
絶対日数に変換する。数値。

DAY

num DAY( str 日付 )
num DAY( num, num, num)
日付に対して曜日を0−6の数値で返す。 0から順に日曜日、月曜日、、、を表す。

DAY_ENG

str DAY_ENG( str 日付 )
str DAY_ENG( num, num, num)
日付に対して曜日を半角の英語の文字列を返す。(Sunday...)

DAY_JPN

str DAY_JPN( str 日付 )
str DAY_JPN( num, num, num)
日付に対して曜日を全角の日本語文字列を返す。(日曜日...)

YEAROF

num YEAROF( str 日付 )
日付表記の年を西暦で取り出す。数値。

MONTHOF

num MONTHOF( str 日付 )
日付表記の月を取り出す。数値。

DAYOF

num DAYOF( str 日付 )
日付表記の日を取り出す。数値。

DATESTR

str DATESTR( str 日付 )
str DATESTR( num, num, num)
標準的な日付記述法の文字列に変換。

DATESTR_JPN

str DATESTR_JPN( str 日付 )
str DATESTR_JPN( num, num, num)
和風日付記述法の文字列に変換。 元号への変換の際、元号の切り替わりの年は新しい元号に属するものとする。

YEAR_JPN

str YEAR_JPN( num 西暦年 )
元号表記に変換する。 元号への変換の際、元号の切り替わりの年は新しい元号に属するものとする。

ISLEAPYEAR

bool ISLEAPYEAR( num 西暦年 )
引数の年が閏年であれば真を返す。論理値。

ISDATE

bool ISDATE( str 日付 )
bool ISDATE( num, num, num)
日付が正常ならば真を返す。論理値。
現在の版では、厳密な検査は行われていない。

TODAY

str TODAY()
現在の日付。文字列表記。

COUNT2DATE

str COUNT2DATE( num 絶対日数 )
絶対日数を日付の形式に変換する。結果は文字列。
不正、または、計算不能な場合はヌルの文字列が戻ることがある。

年齢

AGE

num AGE( str 誕生日付 , str 本日日付 )
年齢を返す。戻り値は数値。引数は文字列。

干支

ETO12

num ETO12( num )
十二支のコードを数値で返す。子年が0。

ETO12STR

str ETO12STR( num[ , bool 読みフラグ ] )
十二支を文字列で返す。 読みフラグをTRUEにすると、ひらがな表記で返す。 読みフラグを省略すると、通常の漢字表記。

ETO10

num ETO10( num )
十干のコードを数値で返す。甲が0。

ETO10STR

str ETO10STR( num[ , bool 読みフラグ ] )
十干を文字列で返す。 読みフラグをTRUEにすると、ひらがな表記で返す。 読みフラグを省略すると、通常の漢字表記。

ETOSTR

str ETOSTR( num[ , bool 読みフラグ ] )
十干十二支を文字列で返す。 読みフラグをTRUEにすると、ひらがな表記で返す。 読みフラグを省略すると、通常の漢字表記。

星座

ZODIAC

num ZODIAC( str 日付 )
num ZODIAC( num, num)
誕生星座を0−11の数値で返す。
0から順に、山羊、水瓶、魚、牡羊、牡牛、双子、蟹、獅子、乙女、天秤、蠍、射手を表す (天宮では、牡羊から始まるが、生年月日で1月から現れるものとして、山羊座から始めた)。

ZODIAC_JPN

str ZODIAC_JPN( str 日付 )
str ZODIAC_JPN( num, num)
誕生星座を日本語文字列で返す。

ZODIAC_ENG

str ZODIAC_ENG( str 日付 )
str ZODIAC_ENG( num, num)
誕生星座を英語文字列で返す。