日付と時刻の関数
日付／時刻の要素を抽出し、日付を計算する関数です。
タイムスタンプの扱い
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
()現在のUTCタイムスタンプを、Unixエポックからの経過ミリ秒で返します。
| 戻り値 | 数値 |
| 例 | 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オフセットを指定します。 | |||||||||
| 関連項目 |
関連トピック
- 式の概要：すべての式関数。
プロセスをより良く設計し、つながりのあるアーキテクチャを構築して、管理を続けましょう。
クレジットカード不要、待ち時間なしですぐにご利用いただけます。組織の業務の進め方を、明確につながるプロセス設計として可視化します。
プロセスアーキテクチャを構築し、オーナーシップと統制を定め、あらゆる階層で役割と責任を明確にします。
無料トライアルを開始して、プロセスのガバナンス、管理、継続的な改善を支える信頼できる基盤を築きましょう。