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 |
---|---|---|
get | Object | Pobiera etykietę tego pola. |
set |
| Ustawia etykietę tego pola. |
Wycofane metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
| void | Usuwa tę datę. |
| Integer | Pobiera dzień miesiąca dla tej daty. |
| Month | Pobiera miesiąc, w którym przypada dana data. |
| Integer | Pobiera rok dla tej daty. |
|
| Ustawia datę na bieżący dzień bez roku. |
|
| Ustawia datę na bieżący dzień. |
|
| 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
– to pole, przydatne do łańcuchowaniaDate
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()
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()
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
get
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()
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()
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)
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
— ta data, przydatna do łańcuchowaniaDate
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)
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
— ta data, przydatna do łańcuchowaniaDate
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)
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 |
| nowa etykieta standardowa |
Powrót
– to pole, przydatne do łańcuchowaniaDate
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.google.com/m8/feeds