날짜 및 시간 함수
날짜와 시간 구성 요소를 추출하고 날짜 연산을 수행하는 함수입니다.
타임스탬프 사용
ProcessMind에서 타임스탬프는 1970년 1월 1일(Unix epoch) 이후 경과한 밀리초를 나타내는 숫자로 저장됩니다. 날짜 함수는 이 타임스탬프 값을 사용합니다.
자주 사용하는 패턴
-
날짜 구성 요소 추출:
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 epoch 이후 경과한 밀리초로 반환합니다.
| 반환값 | 숫자 |
| 예시 | 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일에 하루 더하기 | |||||||||
| 관련 항목 |
dateDiff
(startTimestamp, endTimestamp, unit)두 타임스탬프 사이의 차이를 지정한 단위로 계산합니다.
| 매개변수 |
| |||||||||
| 반환값 | 숫자 | |||||||||
| 예시 | dateDiff(StartTime, EndTime, "minute") → 150 분 단위 소요 시간 dateDiff(StartTime, EndTime, "hour") → 2.5 | |||||||||
| 참고 | 정확한 차이를 나타내는 소수 값을 반환합니다. | |||||||||
| 관련 항목 |
isBusinessDay
(timestamp)타임스탬프가 영업일(월요일~금요일)에 해당하는지 확인합니다.
| 매개변수 |
| |||
| 반환값 | 불리언 | |||
| 예시 | isBusinessDay(StartTime) → true StartTime이 평일인 경우 | |||
| 관련 항목 |
workingDaysBetween
(startTimestamp, endTimestamp)두 타임스탬프 사이의 영업일(월요일~금요일) 수를 계산합니다.
| 매개변수 |
| ||||||
| 반환값 | 숫자 | ||||||
| 예시 | 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로 변환 | ||||||
| 참고 | 현재 시간대 변환은 시간 단위의 숫자 UTC 오프셋을 지원하며, IANA 시간대 이름은 지원하지 않습니다. | ||||||
| 관련 항목 |
toLocal
(timestamp, offsetHours)시간대 오프셋을 더해 UTC 타임스탬프를 현지 시간으로 변환합니다.
| 매개변수 |
| ||||||
| 반환값 | 숫자 | ||||||
| 예시 | toLocal(StartTime, -5) → StartTime에서 5시간 빼기 EST로 변환 toLocal(1710766245000, -5) → 1710748245000 UTC 타임스탬프를 EST(UTC-5)로 변환 | ||||||
| 참고 | 현재 시간대 변환은 시간 단위의 숫자 UTC 오프셋을 지원하며, IANA 시간대 이름은 지원하지 않습니다. | ||||||
| 관련 항목 |
convertTimezone
(timestamp, fromOffset, toOffset)타임스탬프를 한 시간대에서 다른 시간대로 변환합니다.
| 매개변수 |
| |||||||||
| 반환값 | 숫자 | |||||||||
| 예시 | convertTimezone(StartTime, 1, -5) → 타임스탬프에서 6시간 조정 CET에서 EST로 convertTimezone(1710766245000, 1, -5) → 1710744645000 UTC+1에서 UTC-5로 변환 | |||||||||
| 참고 | 현재 시간대 변환은 시간 단위의 숫자 UTC 오프셋을 지원하며, IANA 시간대 이름은 지원하지 않습니다. | |||||||||
| 관련 항목 |
관련 주제
- 표현식 개요: 모든 표현식 함수입니다.
더 나은 프로세스를 설계하고, 연결된 아키텍처를 구축해 관리하세요.
신용카드 등록이나 대기 없이 바로 이용할 수 있습니다. 조직의 업무 방식을 명확하고 유기적으로 연결된 프로세스 설계로 바꿔 보세요.
프로세스 아키텍처를 구축하고, 소유권과 통제 기준을 정립하며, 모든 계층의 역할과 책임을 조율하세요.
무료 체험을 시작하고 프로세스를 관리·운영하고 지속적으로 개선할 수 있는 신뢰할 만한 기반을 마련하세요.