MONTH Function

Derives the month integer value from a Datetime value. Source value can be a a reference to a column containing Datetime values or a literal.

NOTE: If the source Datetime value does not include a valid input for this function, a missing value is returned.

Basic Usage

derive value:MONTH(MyDate)

Output: Generates a column of values that include the numeric month values from the MyDate column.


derive value:MONTH(datetime_col)

ArgumentRequired?Data TypeDescription
datetime_colYdatetimeName of column whose month values are to be computed

For more information on syntax standards, see Language Documentation Syntax Notes.


Name of the column whose month value is to be computed.

  • Missing values for this function in the source data result in missing values in the output.
  • Multiple columns and wildcards are not supported.

Usage Notes:

Required?Data TypeExample Value


Example - Date element functions

This example illustrates how a variety of date-related functions can be used to derive specific values out of a column of Datetime type.

  • YEAR - Returns the four-digit year value from a Datetime value. See YEAR Function.
  • MONTH - Returns the two-digit month value from a Datetime value. See MONTH Function.
  • MONTHNAME - Returns the full month name value from a Datetime value. See MONTHNAME Function.
  • DAY - Returns the day of the month as a numeric value from a Datetime value. See DAY Function.
  • HOUR - Returns the hour value on a 24-hour scale from a Datetime value. See HOUR Function.
  • MINUTE - Returns the minutes value from a Datetime value. See MINUTE Function.
  • SECOND - Returns the seconds value from a Datetime value. See SECOND Function.


2/8/16 15:41
12/30/15 0:00
4/26/15 7:07


derive value: YEAR (date)

derive value: MONTH (date)

derive value: MONTHNAME (date)

derive value: DAY (date)

derive value: HOUR (date)

derive value: MINUTE (date)

derive value: SECOND (date)


NOTE: If the source Datetime value does not contain a valid input for one of these functions, no value is returned. See the second_date column below.

2/8/16 15:4120162February81541
12/30/15 0:00201512December3000
4/26/15 7:0720154April2677

Send feedback about...

Google Cloud Dataprep Documentation