기능 금요일: 날짜 및 시간 추가

이번에는 Power Automate의 날짜 및 시간 기능에 대해 자세히 살펴보겠습니다. 날짜 및 시간은 흐름 작업에서 가장 고통스러운 부분 중 하나입니다.

그 이유는 DateTime 값이 DateTime일 때도 있고 숫자일 때도 있고 문자열일 때도 있기 때문입니다. 일반적으로 문자열입니다… 대부분입니다. 그리고 어떤 순간에 그것이 무엇인지 아는 것은 어렵습니다. 그런 다음 DateTime 값이 모든 다양한 외부 시스템과 주고받을 수 있는 다양한 형식을 추가하면 또 다른 복잡성 계층이 생깁니다. 그리고 또 다른 수준의 복잡성을 위해 시간대 문제를 추가할 것입니다.

이 게시물에서는 간단하게 시작하겠습니다: 날짜 및 시간 추가.

addDays, addHours, addMinutes, addSeconds

이 네 가지 기능은 모두 똑같은 방식으로 작동합니다. 각 함수는 세 개의 입력 매개변수를 사용합니다. 처음 두 개의 매개변수인 타임스탬프와 값이 필요합니다. 세 번째 매개변수인 형식은 선택 사항입니다.

기능은 다음과 같습니다.

addDays('<timestamp>', <value>, '<format>')
addHours('<timestamp>', <value>, '<format>')
addMinutes('<timestamp>', <value>, '<format>')
addSeconds('<timestamp>', <value>, '<format>')

타임스탬프는 입력 값으로 시작하는 DateTime입니다. 이것은 문자열로 전달됩니다.

값 매개변수는 추가할 양(일, 시간, 분 또는 초)입니다. 이 값은 양수 또는 음수일 수 있습니다. "빼기"기능이 없으므로 반대 방향으로 이동해야 하는 경우 음수 값으로 더하기 기능을 사용합니다.

타임스탬프의 기본 가정 형식은 "yyyy-MM-ddTHH:mm:ss.fffffffK"로 표시되는 ISO 8601입니다.

yyyy는 2022년

을 나타냅니다.

MM은 월을 나타냅니다. 모든 값에서 한 자리 값은 앞에 0이 붙습니다: 08

dd는 날짜를 나타냅니다: 12

T는 값의 날짜와 시간 부분 사이에 있는 자리 표시자입니다

.

HH는 군사 시간의 시간을 나타냅니다: 14

mm은 분을 나타냅니다: 00

ss는 초를 나타냅니다: 05

fffffff는 마이크로초를 나타냅니다. 0051332

K는 시간대를 나타냅니다. UTC는 Z로 표시됩니다

.

타임스탬프 값이 해당 형식이 아닌 경우(예: "MM/dd/yyyy"또는 다른 형식으로 전달된 경우) 이 매개변수에서 해당 형식을 지정해야 합니다. 다음 중 하나를 수행할 수 있습니다. 표준 형식 중 하나를 전달하거나 사용자 정의 형식을 정의합니다.날짜 형식in the docs here에 대한 자세한 내용을 읽을 수 있습니다.

출력 결과는 항상 입력 타임스탬프와 동일한 형식입니다. 출력 형식을 변경해야 하는 경우 출력을 formatDateTime 함수로 전달해야 합니다. 이에 대해서는 다른 게시물에서 다룰 것입니다.

몇 가지 예:

addDays('2022-08-11T12:00:00.0000001Z', 1) // returns '2022-08-12T12:00:00.0000001Z'

addHours('2022-08-11T12:00:00.0000000Z', 3) // returns '2022-08-11T15:00:00.0000000Z'

addMinutes('2022-08-11T12:00:00Z', 13) // returns '2022-08-11T12:13:00Z'

addToTime

addToTime 함수는 좀 더 일반적인 함수입니다. 타임스탬프를 사용하여 초, 분, 시간, 일, 주, 월 또는 년을 더하거나 뺄 수 있습니다. 패턴은 다음과 같습니다.

addToTime('<timestamp>', <interval>, '<unit>', 'format')

다른 "추가"기능과 마찬가지로 형식은 선택적 매개변수입니다. 나머지 세 매개변수는 필수입니다.

타임스탬프는 다른 함수와 완전히 동일합니다. 간격은 타임스탬프에 추가할 시간입니다. 양수 또는 음수 값일 수 있습니다.

단위는 추가할 간격 유형을 함수에 알려줍니다. 허용되는 값은 "초", "분", "시", "일", "주", "월", "연도"입니다.

예:

addToTime('2022-08-11', 10, 'Year') // returns '2032-08-11'

결론

Power Automate에서 날짜 및 시간을 사용하여 작업하는 데 많은 작업이 있으며 이제 막 그 혼란에 뛰어들기 시작했습니다. 다음 시간에는 서식 지정 및 구문 분석에 대해 자세히 살펴보겠습니다.

게시물Function Friday: Date and Time Addition은 Barret Codes에 처음 등장했습니다.