1. Home
  2. On-premises 5.1
  3. Guides
  4. Tours
  5. Concepts
  6. Tools
  7. References
  8. Integrations
  9. Data applications
  10. Releases

Built-in Functions → monthStartDate

monthStartDate() is a scalar date function that returns the date of the first day of the current month.

Signature

monthStartDate()

Returns

Date representing the first date of the current month.

Example

Consider a case where you want to identify the beginning of the current month and the sales revenue that occurred before the start of the month, for instance, 06/01/2021.

  • Start date of the current month
monthStartDate()
  • Sales prior to month start
SALES.SALES.TIME_ID < monthStartDate()

The following table illustrates the behavior of the monthStartDate() date function:

ProductRevenuesSales DatemonthStartDate()Sales prior to monthStartDate()
CD$20005/11/202106/01/2021true
Hard disk$60005/12/202106/01/2021true
Cable$55005/14/202106/01/2021true
Hardware$80005/21/202106/01/2021true
Memory Card$22006/02/202106/01/2021false

Use the following steps for detailed instructions on how to use the monthStartDate() date function:

Note

In the Cluster Management Console (CMC), create a tenant that includes Sample Data. The Sample Data includes the SALES schema.

  • In the Navigation bar, select the Content tab, and then select + New → Add Dashboard.
  • In the Add Dashboard dialog, for Name, enter Product Dashboard, and then select Add.
  • In the Action bar, select + (add icon), or select + Add Insight.
  • In the Insight panel, select Listing Table or V.
  • In Tables, select Aggregated Table.
  • In the Data panel, select Manage Dataset (+).
  • In the Manage Data Sets panel, in Tables, select SALES. Close the panel.
  • From the Data panel, drag and drop the following columns to the respective tray:
    • From the Products table, drag and drop Category to the Grouping Dimension tray.
    • From the Sales table, drag and drop Revenue to the Measure tray. In the Properties panel,
      • For Number Format, select Dollar Rounded.
  • From the Data panel, drag and drop Add Formula to the Grouping Dimension tray.
  • The Formula Builder automatically opens:
    • In Search Functions, select the down arrow, and then select Date Functions.
    • Double-click the monthStartDate function, monthStartDate(), to add the formula to the editor.
    • Select Validate & Save.
    • In the Properties panel, for Column Label, enter monthStartDate().
  • From the Data panel, drag and drop Add Formula to the Grouping Dimension tray.
    • In the Formula Editor, use the following condition:
      • SALES.SALES.TIME_ID < monthStartDate()
    • Select Validate & Save.
    • In the Properties panel, for Column Label, enter Sales prior to monthStartDate()
  • Name the insight Revenue Per Product Category.
  • In the Action bar, select Save.