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

MetodaZwracany typKrótki opis
getLabel()ObjectPobiera etykietę tego pola.
setLabel(label)DateFieldUstawia etykietę tego pola.
MetodaZwracany typKrótki opis
deleteDateField()voidUsuwa tę datę.
getDay()IntegerPobiera dzień miesiąca dla tej daty.
getMonth()MonthPobiera miesiąc, w którym przypada dana data.
getYear()IntegerPobiera rok dla tej daty.
setDate(month, day)DateFieldUstawia datę na bieżący dzień bez roku.
setDate(month, day, year)DateFieldUstawia datę na bieżący dzień.
setLabel(label)DateFieldOkreś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

NazwaTypOpis
labelStringnowa 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

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

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

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

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

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

NazwaTypOpis
monthMonthmiesiąc
dayIntegerdzień

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

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

NazwaTypOpis
monthMonthmiesiąc
dayIntegerdzień
yearIntegerrok

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

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

NazwaTypOpis
labelFieldnowa 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