# Current-period macro

Learn how to get the current week, month, or year.

This macro returns the current week, month, or year. It can be used to extract a temporal value representing the current period in various formats.

To determine the current period, this macro uses the time zone and locale configured at the [application level](/explanation/application/overview). These settings define the daylight saving time rules and which days of the week are weekdays or weekend days.

## Syntax

This macro has the following syntax:

```cql
this /*<period>*/
```

The `/*<period>*/` is a literal word that represents a specific date-time period and cannot be specified dynamically using expressions.

Here is a list of the supported period specifiers:

| Period  | Description                                     | Example    |
| ------- | ----------------------------------------------- | ---------- |
| `week`  | A temporal value representing the current week. | `2026-W31` |
| `month` | A temporal value representing the current month | `2026-08`  |
| `year`  | An integer value representing the current year. | `2026`     |

## Examples

Here is an example of how to get the current week:

```cql
this week // 2026-W31
```

You can also get the current month:

```cql
this month // 2026-08
```

And the current year:

```cql
this year // 2026
```