사용자가 날짜와 시간을 입력할 수 있는 입력란입니다.
Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.
const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or // string is acceptable. .setValueInMsSinceEpoch(1514775600) // EDT time is 5 hours behind UTC. .setTimeZoneOffsetInMins(-5 * 60) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
set | Date | UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택 도구를 식별하는 필드 이름을 설정합니다. |
set | Date | 선택 도구 입력이 변경될 때마다 스크립트가 실행하는 Action 를 설정합니다. |
set | Date | 시간대가 UTC와 얼마나 차이가 있는지 분 단위로 설정합니다. |
set | Date | 입력란 위에 표시되는 제목을 설정합니다. |
set | Date | 입력란에 설정할 미리 채워진 값을 설정합니다. |
set | Date | 입력란에 설정할 미리 채워진 값을 설정합니다. |
자세한 문서
setFieldName(fieldName)
UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택 도구를 식별하는 필드 이름을 설정합니다. 필드 이름은 사용자에게 표시됩니다. 필수사항입니다. 지정된 필드 이름은 고유해야 합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
field | String | 이 입력에 할당할 이름입니다. |
리턴
Date
: 체이닝을 위한 선택 도구입니다.
setOnChangeAction(action)
선택 도구 입력이 변경될 때마다 스크립트가 실행하는 Action
를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
action | Action | 수행할 작업입니다. |
리턴
Date
: 체이닝을 위한 선택 도구입니다.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
시간대가 UTC와 얼마나 차이가 있는지 분 단위로 설정합니다. 설정하면 날짜와 시간이 지정된 시간대에 표시됩니다. 설정하지 않으면 시간은 사용자의 시간대로 표시됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
time | Integer | 시간대가 UTC와 얼마나 차이가 나는지 분 단위로 나타낸 값입니다. |
리턴
Date
: 체이닝을 위한 선택 도구입니다.
setTitle(title)
setValueInMsSinceEpoch(valueMsEpoch)
입력란에 설정할 미리 채워진 값을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
value | Number | 입력에 숫자로 배치되는 기본값으로, 에포크 이후 경과된 시간을 밀리초 단위로 나타냅니다. 항상 양식 콜백 매개변수에서 문자열로 표시됩니다. |
리턴
Date
: 체이닝을 위한 선택 도구입니다.
setValueInMsSinceEpoch(valueMsEpoch)
입력란에 설정할 미리 채워진 값을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
value | String | 입력에 문자열로 배치되는 기본값으로, 에포크 이후 경과된 시간을 밀리초로 나타냅니다. 항상 양식 콜백 매개변수에서 문자열로 표현됩니다. |
리턴
Date
: 체이닝을 위한 선택 도구입니다.