Class DateTimePicker

날짜시간선택 도구

사용자가 날짜와 시간을 입력할 수 있는 입력란입니다.

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'),
        );

메서드

메서드반환 유형간략한 설명
setFieldName(fieldName)DateTimePickerUI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택 도구를 식별하는 필드 이름을 설정합니다.
setOnChangeAction(action)DateTimePicker선택 도구 입력이 변경될 때마다 스크립트가 실행하는 Action를 설정합니다.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePicker시간대가 UTC와 얼마나 차이가 있는지 분 단위로 설정합니다.
setTitle(title)DateTimePicker입력란 위에 표시되는 제목을 설정합니다.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker입력란에 설정할 미리 채워진 값을 설정합니다.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker입력란에 설정할 미리 채워진 값을 설정합니다.

자세한 문서

setFieldName(fieldName)

UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 선택 도구를 식별하는 필드 이름을 설정합니다. 필드 이름은 사용자에게 표시됩니다. 필수사항입니다. 지정된 필드 이름은 고유해야 합니다.

매개변수

이름유형설명
fieldNameString이 입력에 할당할 이름입니다.

리턴

DateTimePicker: 체이닝을 위한 선택 도구입니다.


setOnChangeAction(action)

선택 도구 입력이 변경될 때마다 스크립트가 실행하는 Action를 설정합니다.

매개변수

이름유형설명
actionAction수행할 작업입니다.

리턴

DateTimePicker: 체이닝을 위한 선택 도구입니다.


setTimeZoneOffsetInMins(timeZoneOffsetMins)

시간대가 UTC와 얼마나 차이가 있는지 분 단위로 설정합니다. 설정하면 날짜와 시간이 지정된 시간대에 표시됩니다. 설정하지 않으면 시간은 사용자의 시간대로 표시됩니다.

매개변수

이름유형설명
timeZoneOffsetMinsInteger시간대가 UTC와 얼마나 차이가 나는지 분 단위로 나타낸 값입니다.

리턴

DateTimePicker: 체이닝을 위한 선택 도구입니다.


setTitle(title)

입력란 위에 표시되는 제목을 설정합니다.

매개변수

이름유형설명
titleString입력란 제목입니다.

리턴

DateTimePicker: 체이닝을 위한 선택 도구입니다.


setValueInMsSinceEpoch(valueMsEpoch)

입력란에 설정할 미리 채워진 값을 설정합니다.

매개변수

이름유형설명
valueMsEpochNumber입력에 숫자로 배치되는 기본값으로, 에포크 이후 경과된 시간을 밀리초 단위로 나타냅니다. 항상 양식 콜백 매개변수에서 문자열로 표시됩니다.

리턴

DateTimePicker: 체이닝을 위한 선택 도구입니다.


setValueInMsSinceEpoch(valueMsEpoch)

입력란에 설정할 미리 채워진 값을 설정합니다.

매개변수

이름유형설명
valueMsEpochString입력에 문자열로 배치되는 기본값으로, 에포크 이후 경과된 시간을 밀리초로 나타냅니다. 항상 양식 콜백 매개변수에서 문자열로 표현됩니다.

리턴

DateTimePicker: 체이닝을 위한 선택 도구입니다.