Class DateField

Trường Ngày

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