Send feedback
Class DateField
Stay organized with collections
Save and categorize content based on your preferences.
DateField
Deprecated. Instead, use the People API advanced
service
A date field in a Contact.
This class is only used by the Contacts service, and dates used elsewhere in App Script use
JavaScript's standard
Date object.
Detailed documentation
getLabel()
Gets the label for this field. This may be a Field, ExtendedField, or a String.
// 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 ());
}
Return
Object
— the label for this field
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
setLabel(label)
Sets the label of this field.
// 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' );
Parameters
Name Type Description
label
String
the new label for this field
Return
DateField
— this field, useful for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
Deprecated methods
deleteDateField()
Deprecated. This function is deprecated and should not be used in new scripts.
Deletes this date.
// 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 ();
}
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
getDay()
Deprecated. This function is deprecated and should not be used in new scripts.
Gets the day of the month for this date.
Note: For standard JavaScript Date objects the
getDay()
method returns the day of the week instead.
// 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 ());
Return
Integer
— the day of the month
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
getMonth()
Deprecated. This function is deprecated and should not be used in new scripts.
Gets the month for this date.
// 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 ());
Return
Month
— the month
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
getYear()
Deprecated. This function is deprecated and should not be used in new scripts.
Gets the year for this date.
// 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 ());
Return
Integer
— the year
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
setDate(month, day)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the date to this day, without a year.
This method only applies to date fields that don't require a year, such as birthdays.
// 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 );
Parameters
Name Type Description
month
Month
the month
day
Integer
the day
Return
DateField
— this date, useful for chaining
Throws
Error
— if this date field requires a year
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
setDate(month, day, year)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the date to this day.
// 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 );
Parameters
Name Type Description
month
Month
the month
day
Integer
the day
year
Integer
the year
Return
DateField
— this date, useful for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
setLabel(label)
Deprecated. This function is deprecated and should not be used in new scripts.
Sets the label of this field, such as 'Birthday' or 'Anniversary'.
// 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 );
Parameters
Name Type Description
label
Field
the new standard label
Return
DateField
— this field, useful for chaining
Authorization
Scripts that use this method require authorization with one or more of the following scopes :
https://www.google.com/m8/feeds
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-12-16 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
Need to tell us more?
{
"lastModified": "Last updated 2022-12-16 UTC.",
"confidential": False
}