Class DateField

Datapole

Wycofany. Zamiast tego użyj zaawansowanego interfejsu People API.

Pole daty w kontakcie.

Ta klasa jest używana tylko przez usługę Kontakty, a dat używanych w innych miejscach w App Script używa standardowego obiektu Date języka JavaScript.

Metody

Metoda	Zwracany typ	Krótki opis
getLabel()	Object	Pobiera etykietę tego pola.
setLabel(label)	DateField	Ustawia etykietę tego pola.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
deleteDateField()	void	Usuwa tę datę.
getDay()	Integer	Pobiera dzień miesiąca dla tej daty.
getMonth()	Month	Pobiera miesiąc, w którym przypada dana data.
getYear()	Integer	Pobiera rok dla tej daty.
setDate(month, day)	DateField	Ustawia datę na bieżący dzień bez roku.
setDate(month, day, year)	DateField	Ustawia datę na bieżący dzień.
setLabel(label)	DateField	Określa etykietę tego pola, np. „Urodziny” lub „Rocznica”.

Szczegółowa dokumentacja

getLabel()

Pobiera etykietę tego pola. Może to być pole, rozszerzone pole lub ciąg znaków.

// 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());
}

Powrót

Object – etykieta tego pola

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setLabel(label)

Ustawia etykietę tego pola.

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

Parametry

Nazwa	Typ	Opis
label	String	nowa etykieta tego pola.

Powrót

DateField – to pole, przydatne do łańcuchowania

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Wycofane metody

deleteDateField()

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Usuwa tę datę.

// 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();
}

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getDay()

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera dzień miesiąca dla tej daty.

Uwaga: w przypadku standardowych obiektów Date w JavaScriptie metoda getDay() zwraca zamiast tego dzień tygodnia.

// 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());

Powrót

Integer – dzień miesiąca,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getMonth()

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera miesiąc, w którym przypada dana data.

// 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());

Powrót

Month – miesiąc

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getYear()

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera rok dla tej daty.

// 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());

Powrót

Integer – rok

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setDate(month, day)

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Ustawia datę na bieżący dzień bez roku.

Ta metoda dotyczy tylko pól dat, które nie wymagają podania roku, np. urodzin.

// 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);

Parametry

Nazwa	Typ	Opis
month	Month	miesiąc
day	Integer	dzień

Powrót

DateField — ta data, przydatna do łańcuchowania

Rzuty

Error – jeśli to pole daty wymaga podania roku.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setDate(month, day, year)

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Ustawia datę na bieżący dzień.

// 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);

Parametry

Nazwa	Typ	Opis
month	Month	miesiąc
day	Integer	dzień
year	Integer	rok

Powrót

DateField — ta data, przydatna do łańcuchowania

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setLabel(label)

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Określa etykietę tego pola, np. „Urodziny” lub „Rocznica”.

// 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);

Parametry

Nazwa	Typ	Opis
label	Field	nowa etykieta standardowa

Powrót

DateField – to pole, przydatne do łańcuchowania

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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