Dataphin:付録: 統計期間式の パラメーター

関数リスト

lastNDate

• 使用方法: 過去 N 日間の期間の開始日を決定します。

• パラメーター:

  • (必須) currentDate: yyyyMMdd 形式の現在の日付。

  • (必須) preDays: 遡る日数。整数で指定します。

  • (必須) format: 日付形式。 yyyyMMdd です。

• 戻り値:

  • 過去 N 日間の期間の開始日。 yyyyMMdd 形式の文字列として返されます。

• 例:

  • lastNDate('20180118', 7,'yyyyMMdd') は 20180112 を返します。

cBeginDate

• 使用方法: 以前の N 期間の自然期間の開始日を取得します。

• パラメーター:

  • (必須) currentDate: yyyyMMdd 形式の文字列としての現在の日付。

  • (必須) timeFormat: 自然期間のタイプ。次のオプションがあります。

    • w: 暦週。

    • m: 暦月。

    • q: 暦四半期。

    • y: 暦年。

  • (オプション) length: 遡る自然期間の数。指定しない場合、デフォルトは 1 です。

  • (必須) format: 日付形式。 yyyyMMdd です。

• 戻り値:

  • N 期間前の自然期間の開始日。 yyyyMMdd 形式の文字列として返されます。

• 例:

  • cBeginDate('20180118', 'm','yyyyMMdd') は 20171201 を返します。

  • cBeginDate('20180118', 'w','yyyyMMdd') は 20180108 を返します。

  • cBeginDate('20180118', 'w', 2,'yyyyMMdd') は 20180101 を返します。

cEndDate

• 使用方法: 前の自然期間の終了日を決定します。

• パラメーター:

  • (必須) currentDate: yyyyMMdd 形式の文字列としての現在の日付。

  • (必須) timeFormat: 自然期間のタイプ。次のオプションがあります。

    • w: 暦週。

    • m: 暦月。

    • q: 暦四半期。

    • y: 暦年。

  • (必須) format: 日付形式。 yyyyMMdd です。

• 戻り値:

  • 前の自然期間の終了日。 yyyyMMdd 形式の文字列として返されます。

• 例:

  • cEndDate('20180118', 'm','yyyyMMdd') は 20171231 を返します。

  • cEndDate('20180118', 'w','yyyyMMdd') は 20180114 を返します。

  • cEndDate('20180118', 'y','yyyyMMdd') は 20171231 を返します。

tdBeginDate

• 使用方法: 以前の N 期間の自然期間の開始日を取得します。 cBeginDate とは異なり、length が指定されていない場合、デフォルトは現在の期間の開始になります。この関数は、「今日まで」タイプの指標を計算するのに最適です。

• パラメーター:

  • (必須) currentDate: yyyyMMdd 形式の文字列としての現在の日付。

  • (オプション) timeFormat: 自然期間のタイプ。指定しない場合、デフォルトは 19700101 です。許可されるタイプは次のとおりです。

    • w: 暦週。

    • m: 暦月。

    • q: 暦四半期。

    • y: 暦年。

  • (オプション) length: 遡る自然期間の数。指定しない場合、デフォルトは 0 です。

  • (必須) format: 日付形式。yyyyMMdd です。

• 戻り値:

  • N 期間前の自然期間の開始日。 yyyyMMdd 形式の文字列として返されます。

• 例:

  • tdBeginDate('20180118','yyyyMMdd') は 19700101 を返します。

  • tdBeginDate('20180118', 'm','yyyyMMdd') は 20180101 を返します。

  • tdBeginDate('20180118', 'w','yyyyMMdd') は 20180115 を返します。

  • tdBeginDate('20180118', 'w', 2,'yyyyMMdd') は 20180101 を返します。

CustomBeginDate

• 使用方法: 現在の日付を最初のカスタム期間の一部と見なし、以前の N 期間のカスタム期間の開始日を取得します。この関数は、会計月や会計年度など、変化する期間、期間ルール、またはスライドしながらも固定された期間に従う統計期間の計算に適しています。多くの場合、CustomEndDate と組み合わせて使用されます。

• パラメーター:

  • (必須) currentDate: yyyyMMdd 形式の文字列としての現在の日付。

  • (必須) timeFormat: 自然期間のタイプ。次のオプションがあります。

    • m: 暦月。

    • q: 暦四半期。

    • y: 暦年。

  • (必須) customShift: カスタム期間の開始日。文字列で指定します。年と四半期の場合は MMdd 形式、月の場合はデフォルト形式は dd です。

    説明

    注: dd 値は数字 01～28 のみをサポートしています。

  • (オプション) length: 遡るカスタム期間の数。指定しない場合、デフォルトは 1 です。0 の場合は、現在の期間の開始日を返します。

  • (必須) format: 日付形式。 yyyyMMdd です。

• 戻り値:

  • N 期間前のカスタム期間の開始日。 yyyyMMdd 形式の文字列として返されます。

• 例:

  • CustomBeginDate('20190802', 'y', '0401','yyyyMMdd') は ```html 20180401 を返します。

  • CustomBeginDate('20190802', 'y', '0401', 0,'yyyyMMdd') は 20190401 を返します。

  • CustomBeginDate('20190802', 'q', '0101','yyyyMMdd') は 20190401 を返します。

  • CustomBeginDate('20190802', 'm', '15','yyyyMMdd') は 20190615 を返します。

  • CustomBeginDate('20190802', 'm', '15', 2,'yyyyMMdd') は 20190515 を返します。

CustomEndDate

• 使用方法: 現在の日付を最初のカスタム期間の一部と見なし、以前の N 期間のカスタム期間の終了日を取得します。この関数は、会計月や会計年度など、変化する期間、期間ルール、またはスライドしながらも固定された期間に従う統計期間の計算に適しています。多くの場合、CustomBeginDate と組み合わせて使用されます。

• パラメーター:

  • (必須) currentDate: yyyyMMdd 形式の文字列としての現在の日付。

  • (必須) timeFormat: 自然期間のタイプ。次のオプションがあります。

    • m: 暦月。

    • q: 暦四半期。

    • y: 暦年。

  • (必須) customShift: カスタム期間の開始日。文字列で指定します。年と四半期の場合は MMdd 形式、月の場合はデフォルト形式は dd です。

    説明

    注: dd 値は数字 01～28 のみをサポートしています。

  • (オプション) length: 遡るカスタム期間の数。指定しない場合、デフォルトは 1 です。

  • (必須) format: 日付形式。 yyyyMMdd です。

• 戻り値:

  • N 期間前のカスタム期間の終了日。 yyyyMMdd 形式の文字列として返されます。

• 例:

  • CustomEndDate('20190802', 'y', '0401','yyyyMMdd') は 20190331 を返します。

  • CustomEndDate('20190802', 'q', '0101','yyyyMMdd') は 20190630 を返します。

  • CustomEndDate('20190802', 'm', '15','yyyyMMdd') は 20190714 を返します。

  • CustomEndDate('20190802', 'm', '15', 2,'yyyyMMdd') は 20190614 を返します。

substring

• 使用方法: 指定された開始位置から文字列の末尾までの部分文字列を返します。位置は 1 から始まります。開始位置が負の場合、文字列の末尾から逆算します。

• パラメーター:

  • (必須) currentDate: yyyyMMdd 形式の文字列としての現在の日付。

  • (必須) start: 部分文字列の開始位置。

  • (必須) len: 抽出する部分文字列の長さ。

• 戻り値:

  • 文字列から指定された開始位置から始まる指定された長さの部分文字列を返します。

• 例:

  • substring('20190802',1,4) は 2019 を返します。

  • substring('20190802',1,6) は 201908 を返します。

lastNHour

• 使用方法: 過去 N 時間の期間の開始時刻を決定します。

• パラメーター:

  • (必須) currentDatetime: yyyyMMddHH0000 形式の文字列としての業務時間。

  • (必須) preHours: 遡る時間数。整数で指定します。

• 戻り値:

  • 過去 N 時間の期間の開始時刻。 yyyyMMddHH0000 形式の文字列として返されます。

• 例:

  • lastNHour('20180118160000', 7) は 20180118100000 を返します。

dthBeginDatetime

• 使用方法: 業務時間が含まれる日付の 0 時を取得します。

• パラメーター:

  • (必須) currentDatetime: yyyyMMddHH0000 形式の文字列としての業務時間。

• 戻り値:

  • 業務時間が含まれる日付の 0 時。 yyyyMMdd000000 形式の文字列として返されます。

• 例:

  • dthBeginDatetime('20180118160000') は 20180118000000 を返します。

lastNMinute

• 使用方法: 過去 N 分間の期間の開始分を決定します。

• パラメーター:

  • (必須) currentDatetime: yyyyMMddHHmm00 形式の文字列としての業務時間。

  • (必須) preMinutes: 遡る分数。整数で指定します。

• 戻り値:

  • 過去 N 分間の期間の開始分。 yyyyMMddHHmm00 形式の文字列として返されます。

• 例:

  • lastNMinutes('20180118164500', 45) は 20180118160000 を返します。

dtmiBeginDatetime

• 使用方法: 業務時間が含まれる日付の 0 時を取得します。

• パラメーター:

  • (必須) currentDatetime: yyyyMMddHH0000 形式の文字列としての業務時間。

  • (オプション) timeFormat: 自然期間のタイプ。次のオプションがあります。

    • h: 時間。

• 戻り値:

  • timeFormat パラメーターが h の場合、業務時間が含まれる時間の 0 分を yyyyMMddHH0000 形式で返します。

  • timeFormat パラメーターが指定されていない場合、業務時間が含まれる日付の 0 時を yyyyMMdd000000 形式で返します。

• 例:

  • dtmiBeginDatetime('20180118160000') は 20180118000000 を返します。

  • dtmiBeginDatetime('20180118164500', 'h') は 20180118160000 を返します。

シナリオ

アプリケーション インスタンス