Built-in Functions → monthWeek
monthWeek() is a conversion function that returns the week number of the current month, where a week starts on Sunday and ends on Saturday.
To return the month’s week number for a given date or timestamp, use the monthWeek() conversion function with a parameter.
Signature
monthWeek()
Returns
int representing the current month’s week number.
Example
Identify the week number of the month, for the current date, 08/26/2021.
monthWeek()
The following table illustrates the behavior of the monthWeek() conversion function:
| Product | Revenues | monthWeek() |
|---|---|---|
| CD | $200 | 4 |
| Hard disk | $600 | 4 |
| Cable | $550 | 4 |
| Hardware | $800 | 4 |
| Memory Card | $220 | 4 |
August 26th is in the fourth week of the current month. Thus, the monthWeek is 4.
Use the following steps for detailed instructions on how to use the monthWeek() conversion function to tackle the above example in an insight:
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:
- Category from the PRODUCTS table to the Grouping Dimension tray.
- Revenue from the SALES table 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 Conversion Functions.
- Double-click the second monthWeek function,
monthWeek(), to add the formula to the editor. - Select Validate & Save.
- In the Properties panel, for Column Label, enter monthWeek().
- Name the insight Revenue Per Category.
- In the Action bar, select Save
