Class DateField

DateField

Không dùng nữa. Thay vào đó, hãy sử dụng dịch vụ nâng cao về API Mọi người

Trường ngày trong một mục Liên hệ.

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

Phương thức

Phương thức	Kiểu 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 cho trường này.

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

Phương thức	Kiểu 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 cho ngày này.
setDate(month, day)	DateField	Đặt ngày thành ngày này, không có năm.
setDate(month, day, year)	DateField	Đặt ngày thành ngày này.
setLabel(label)	DateField	Đặt nhãn của trường này, chẳng hạn như 'Ngày sinh' hoặc 'Ngày kỷ niệm'.

Tài liệu chi tiết

getLabel()

Lấy nhãn cho trường này. Đây có thể là một Trường, ExtendedField hoặc một 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Cầu thủ trả bóng

Object – nhãn của trường này

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 cho 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Các tham số

Tên	Loại	Nội dung 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

Tập lệnh sử dụng phương thức này cần đượ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 dùng trong tập lệnh mới.

Xoá ngày này.

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

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 dùng trong 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 của 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'
var contacts = ContactsApp.getContactsByName('John Doe');
var 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

Tập lệnh sử dụng phương thức này cần đượ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 dùng trong 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'
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getMonth());

Cầu thủ trả bóng

Month – tháng

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 dùng trong tập lệnh mới.

Lấy năm cho ngày này.

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

Cầu thủ trả bóng

Integer – năm

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 dùng trong tập lệnh mới.

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

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

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

Các tham số

Tên	Loại	Nội dung 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 một năm

Ủy quyền

Tập lệnh sử dụng phương thức này cần đượ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 dùng trong tập lệnh mới.

Đặt ngày thành ngày này.

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

Các tham số

Tên	Loại	Nội dung 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

Tập lệnh sử dụng phương thức này cần đượ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 dùng trong tập lệnh mới.

Đặt nhãn của trường này, chẳng hạn như 'Ngày sinh' hoặc 'Ngày kỷ niệm'.

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

Các tham số

Tên	Loại	Nội dung mô tả
label	Field	nhãn 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

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

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