Class DateField

DateField

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

Trường ngày trong một Địa chỉ liên hệ.

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

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 cho 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	Tìm 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 cho 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à một 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.
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 cho trường này

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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');

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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên 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'
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 yêu cầu ủy 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 dùng nữa và không nên 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 của JavaScript chuẩn, Thay vào đó, 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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tìm 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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các 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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Đặt ngày thành ngày này, 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ư 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);

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 nhập năm

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các 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);

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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Đặt nhãn cho 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
var contacts = ContactsApp.getContactsByName('John Doe');
var 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

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

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