dadlldate_time

ライブラリ: dadlldate_time

このライブラリには、日付および時刻フィールド、値、および定数に対して機能する共通の機能が含まれています。

 function extern date.const.disp.to.store(
domain daxch.dfor dfor,
const string disp.field(),
ref string store.field())
前 : true
後 : store.field に、disp.field の値が正しく格納されている
説明: : 
- # を伴なう式は、変更なしでコピーされます。
- 特定の表記の日付は日付数値に変換されます (文字列に変換されます)

function extern long date.const.enter.to.disp(
domain daxch.dfor dfor,
ref string disp.field())
前 : true
返値: disp.field が有効な日付定数かどうか
後 : 
ret = true ==> disp.field の値は、old(disp.field) の表示用の値になっています。
ret = false ==> disp.field は変更されません。
説明 : 正しく指定されている日付定数は、次のとおりに表示されます。
- date.num() は # に置換されます。
- [(+-)[n]] は対応する日付として表示されます (指定の日付表記になります)
- 特定の表示形式になっている日付は、そのまま表示されます。

function extern date.const.store.to.disp(
domain daxch.dfor dfor,
const string store.field(),
ref string disp.field())
前 : true
後 : disp.field に、store.field の値が正しく格納されている
説明 : 
- # を伴なう式は、変更なしでコピーされます。
- 日付数値は特定の日付表記に変換されます (文字列に変換されます)

function extern long date.to.format(
domain daxch.dfor dfor,
long ndate )
前 : true
返値: dfor および ndate が有効 ==> ndate の指定書式での表現。それ以外 ==> ndate (ndate は日付数値として扱われる)

function extern string datestr.to.formatstr(
domain daxch.dfor dfor,
const string sdate() )
前 : true
返値: dfor および sdate が有効 ==> sdate の指定書式での表現 (文字列に変換)。それ以外 ==> sdate (sdate は日付数値の文字列表現として扱われる)

function extern long format.to.date(
domain daxch.dfor dfor,
long fdate )
前 : true
返値: dfor および fdate が有効 ==> fdate の日付数値。それ以外 ==> fdate
説明 : 年の表記形式が YY で、世紀を推測する必要がある場合。YY < 50 ならば 21 世紀、それ以外は 20 世紀。

function extern string formatstr.to.datestr(
domain daxch.dfor dfor,
const string sfdate())
前 : true
返値: dfor が有効で、sfdate が有効 ==> fdate の日付数値を文字列として処理。それ以外 ==> str$(lval(sfdate)) (情報が欠落する可能性あり)
説明 : 年の表記形式が YY で、世紀を推測する必要がある場合。YY < 50 ならば 21 世紀、それ以外は 20 世紀。

function extern long get.date.format.length(domain daxch.dfor dfor)
前 : true
返値: dfor で指定されている、日付の長さ。
- 表示形式が YY を含む場合は 6
- 表示形式が YYYY を含む場合は 8
- 表示形式が無効な場合は 0

function extern get.next.interval(
ref domain daxch.utc date.f,
ref domain daxch.utc date.t )
前 : パラメータは時の間隔を表す
後 : パラメータは次の間隔を示す。すなわち、指定された間隔の末尾を始点とする間隔であり、指定された間隔と同じ長さを持つ。より正確には、次のとおり
- date.f = old(date.t) AND
- date.t = date.f + ( old(date.t) - old(date.f))

function extern long hhmmss.to.secs(long hhmmss)
返値: hhmmss 形式の時刻を午前 0:00 以降の秒数 # に変換した値

function extern long secs.to.hhmmss(long secs)
返値: 午前 0:00 を始点とする秒数を hhmmss 形式に変換した時刻

function extern long utc.date.and.time.to.utc(
domain daxch.date date,
domain daxch.time time,
ref domain daxch.utc utc.date )
前 : date および time は UTC による日付/時刻。日付の表示形式は日付数値。時刻の表示形式は hhmmss。
返値: UTC による日付が正しく変換された場合に true。
後 : 返値が true (<> 0) である場合、utc.date には同じ日付および時刻が UTC の表示形式で格納される。
注 : 現地時間を UTC に変換する処理は行われません。日付および時刻が単一の UTC 変数に再換算されるだけです。

function extern long utc.to.utc.date.and.time(
domain daxch.utc utc.date,
ref domain daxch.date date,
ref domain daxch.time time)
前 : utc.date は UTC 表示形式の日付。
返値: UTC 表示形式の日付が正しく変換された場合に true。
後 :返値が true (<> 0) である場合、日付および時刻には utc.date と同じ日付/時刻が格納される。ただし、表示形式は異なる。日付の表示形式は、日付数値。時刻の表示形式は hhmmss。
注 : UTC から現地時間への変換は行われません。utc.date が二つの変数に分割されます。これは、監査サーバで日付および時刻が別個に利用されるためです。