Trang này được dịch bởi Cloud Translation API.

Class DateField

Không dùng nữa. Thay vào đó, hãy sử dụng dịch vụ nâng cao của API People

Trường ngày trong một Người liên hệ.

Lớp này chỉ được dịch vụ Danh bạ sử dụng và các ngày được sử dụng ở nơi khác trong App Script sử dụng đối tượng Ngày chuẩn của JavaScript.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`getLabel()`	`Object`	Lấy nhãn cho trường này.
`setLabel(label)`	`DateField`	Đặt nhãn của trường này.

Các phương thức ngừng hoạt động

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`deleteDateField()`	`void`	Xoá ngày này.
`getDay()`	`Integer`	Lấy ngày trong tháng cho ngày này.
`getMonth()`	`Month`	Lấy tháng cho ngày này.
`getYear()`	`Integer`	Lấy năm của ngày này.
`setDate(month, day)`	`DateField`	Đặt ngày thành hôm nay, không có năm.
`setDate(month, day, year)`	`DateField`	Đặt ngày thành hôm nay.
`setLabel(label)`	`DateField`	Đặt nhãn của trường này, chẳng hạn như "Sinh nhật" hoặc "Kỷ niệm".

Tài liệu chi tiết

`getLabel()`

Lấy nhãn cho trường này. Đây có thể là Trường, ExtendedField hoặc Chuỗi.

// Logs the label for all the address fields associated with contact
// 'John Doe'. This method can be similarly called for any field that has
// a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Cầu thủ trả bóng

Object – nhãn cho trường này

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

`setLabel(label)`

Đặt nhãn của trường này.

// Sets the label to 'Apartment' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Tham số

Tên	Loại	Mô tả
`label`	`String`	nhãn mới cho trường này

Cầu thủ trả bóng

DateField – trường này hữu ích cho việc tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

Các phương thức ngừng hoạt động

`deleteDateField()`

Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.

Xoá ngày này.

// Deletes all the dates that are set for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (let i = 0; i < dates.length; i++) {
  dates[i].deleteDateField();
}

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

`getDay()`

Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.

Lấy ngày trong tháng cho ngày này.

Lưu ý: Đối với các đối tượng Ngày JavaScript tiêu chuẩn, phương thức getDay() sẽ trả về ngày trong tuần.

// Logs the day of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getDay());

Cầu thủ trả bóng

Integer – ngày trong tháng

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

`getMonth()`

Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.

Lấy tháng cho ngày này.

// Logs the month of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getMonth());

Cầu thủ trả bóng

Month – tháng

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

`getYear()`

Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.

Lấy năm của ngày này.

// Logs the year of the birthday for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getYear());

Cầu thủ trả bóng

Integer – năm

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

`setDate(month, day)`

Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.

Đặt ngày thành hôm nay, không có năm.

Phương thức này chỉ áp dụng cho các trường ngày không yêu cầu năm, chẳng hạn như ngày sinh.

// Sets the birthday for contact 'John Doe' to April 1
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1);

Tham số

Tên	Loại	Mô tả
`month`	`Month`	tháng
`day`	`Integer`	ngày

Cầu thủ trả bóng

DateField – ngày này, hữu ích cho việc tạo chuỗi

Gửi

Error – nếu trường ngày này yêu cầu năm

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

`setDate(month, day, year)`

Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.

Đặt ngày thành hôm nay.

// Sets the birthday for contact 'John Doe' to April 1, 1980
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1, 1980);

Tham số

Tên	Loại	Mô tả
`month`	`Month`	tháng
`day`	`Integer`	ngày
`year`	`Integer`	năm

Cầu thủ trả bóng

DateField – ngày này, hữu ích cho việc tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds

`setLabel(label)`

Không dùng nữa. Hàm này không còn được dùng nữa và không nên được sử dụng trong các tập lệnh mới.

Đặt nhãn của trường này, chẳng hạn như "Sinh nhật" hoặc "Kỷ niệm".

// Retrieves the first date that's set for contact 'John Doe' and re-labels
// it as an anniversary
const contacts = ContactsApp.getContactsByName('John Doe');
const firstDate = contacts[0].getDates()[0];
firstDate.setLabel(ContactsApp.Field.ANNIVERSARY);

Tham số

Tên	Loại	Mô tả
`label`	`Field`	nhãn tiêu chuẩn mới

Cầu thủ trả bóng

DateField – trường này hữu ích cho việc tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.google.com/m8/feeds