日付と時刻の関数
日付や時刻の要素を抽出し、日付の計算を行う関数です。
タイムスタンプの操作
ProcessMindでは、タイムスタンプを1970年1月1日（Unixエポック）からの経過ミリ秒を表す数値として保存します。日付関数は、これらのタイムスタンプ値を処理します。
よく使うパターン
-
日付の要素を抽出：
year(StartTime) // 2024 month(StartTime) // 3 (March) day(StartTime) // 15 -
期間を計算：
dateDiff(StartTime, EndTime, "minute") dateDiff(StartTime, EndTime, "hour") dateDiff(StartTime, EndTime, "day") -
時間単位のバケットを作成：
bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") -
日付に時間を加算：
dateAdd(StartTime, 7, "day") // Add 7 days dateAdd(StartTime, -1, "month") // Subtract 1 month
now
()Unixエポックからの経過ミリ秒で、現在のUTCタイムスタンプを返します。
| 戻り値 | 数値 |
| 例 | now() → 1708963200000 現在のタイムスタンプ |
year
(timestamp)タイムスタンプから年を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | year(StartTime) → 2024 | |||
| 関連項目 |
month
(timestamp)タイムスタンプから月（1～12）を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | month(StartTime) → 3 3月 | |||
| 関連項目 |
day
(timestamp)タイムスタンプから日（1～31）を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | day(StartTime) → 18 | |||
| 関連項目 |
hour
(timestamp)タイムスタンプから時（0～23）を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | hour(StartTime) → 14 午後2時 | |||
| 関連項目 |
minute
(timestamp)タイムスタンプから分（0～59）を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | minute(StartTime) → 30 | |||
| 関連項目 |
second
(timestamp)タイムスタンプから秒（0～59）を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | second(StartTime) → 45 | |||
| 関連項目 |
dayOfWeek
(timestamp)タイムスタンプから曜日を返します。月曜日を1、日曜日を7として表します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | dayOfWeek(StartTime) → 1 月曜日 | |||
| 関連項目 |
dayName
(timestamp)タイムスタンプから曜日名を返します。
| パラメーター |
| |||
| 戻り値 | 文字列 | |||
| 例 | dayName(StartTime) → 月曜日 | |||
| 関連項目 |
monthName
(timestamp)タイムスタンプから月名を返します。
| パラメーター |
| |||
| 戻り値 | 文字列 | |||
| 例 | monthName(StartTime) → 3月 | |||
| 関連項目 |
quarter
(timestamp)タイムスタンプから四半期（1～4）を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | quarter(StartTime) → 1 第1四半期（1月～3月） | |||
| 関連項目 |
weekOfYear
(timestamp)タイムスタンプからISO週番号（1～53）を返します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | weekOfYear(StartTime) → 12 2024年第12週 | |||
| 関連項目 |
dayOfYear
(timestamp)タイムスタンプから年内の日（1～366）を抽出します。
| パラメーター |
| |||
| 戻り値 | 数値 | |||
| 例 | dayOfYear(StartTime) → 78 年の78日目（2024年3月18日） | |||
| 関連項目 |
dateAdd
(timestamp, amount, unit)タイムスタンプに指定した時間を加算します。
| パラメーター |
| |||||||||
| 戻り値 | 数値 | |||||||||
| 例 | dateAdd(StartTime, 7, "day") → タイムスタンプ＋7日 dateAdd(StartTime, -1, "month") → タイムスタンプ－1か月 dateAdd(1710766245000, 1, "day") → 1710852645000 2024年3月18日に1日加算 | |||||||||
| 関連項目 |
dateDiff
(startTimestamp, endTimestamp, unit)指定した単位で2つのタイムスタンプの差を計算します。
| パラメーター |
| |||||||||
| 戻り値 | 数値 | |||||||||
| 例 | dateDiff(StartTime, EndTime, "minute") → 150 分単位の期間 dateDiff(StartTime, EndTime, "hour") → 2.5 | |||||||||
| 注記 | 正確な差を表す小数値を返します。 | |||||||||
| 関連項目 |
isBusinessDay
(timestamp)タイムスタンプが月曜日から金曜日までの営業日に該当するかを確認します。
| パラメーター |
| |||
| 戻り値 | ブール値 | |||
| 例 | isBusinessDay(StartTime) → true StartTimeが平日の場合 | |||
| 関連項目 |
workingDaysBetween
(startTimestamp, endTimestamp)2つのタイムスタンプの間にある営業日（月曜日から金曜日）を数えます。
| パラメーター |
| ||||||
| 戻り値 | 数値 | ||||||
| 例 | workingDaysBetween(StartTime, EndTime) → 日付間の平日数 workingDaysBetween(1710766245000, 1711371045000) → 5 2024年3月18日（月）から3月25日（月）までの5営業日 | ||||||
| 注記 | バックエンドや営業日カレンダー向けの概算ヘルパーです。祝日は考慮せず、週末のみを除外します。 | ||||||
| 関連項目 |
toUtc
(timestamp, offsetHours)オフセットを引いて、現地のタイムスタンプをUTCに変換します。
| パラメーター |
| ||||||
| 戻り値 | 数値 | ||||||
| 例 | toUtc(StartTime, 2) → StartTime－2時間 UTC+2から変換 toUtc(1710766245000, 2) → 1710759045000 タイムスタンプをUTC+2からUTCに変換 | ||||||
| 注記 | タイムゾーン変換で現在サポートされているのは、IANAタイムゾーン名ではなく、時間単位の数値によるUTCオフセットです。 | ||||||
| 関連項目 |
toLocal
(timestamp, offsetHours)オフセットを加えて、UTCのタイムスタンプを現地時間に変換します。
| パラメーター |
| ||||||
| 戻り値 | 数値 | ||||||
| 例 | toLocal(StartTime, -5) → StartTimeから5時間 ESTに変換 toLocal(1710766245000, -5) → 1710748245000 UTCのタイムスタンプをEST（UTC-5）に変換 | ||||||
| 注記 | タイムゾーン変換で現在サポートされているのは、IANAタイムゾーン名ではなく、時間単位の数値によるUTCオフセットです。 | ||||||
| 関連項目 |
convertTimezone
(timestamp, fromOffset, toOffset)タイムスタンプをあるタイムゾーンから別のタイムゾーンに変換します。
| パラメーター |
| |||||||||
| 戻り値 | 数値 | |||||||||
| 例 | convertTimezone(StartTime, 1, -5) → タイムスタンプを6時間調整 CETからEST convertTimezone(1710766245000, 1, -5) → 1710744645000 UTC+1からUTC-5に変換 | |||||||||
| 注記 | タイムゾーン変換で現在サポートされているのは、IANAタイムゾーン名ではなく、時間単位の数値によるUTCオフセットです。 | |||||||||
| 関連項目 |
関連トピック
- 式の概要：すべての式関数。