# Get Specific Time

> Get a specific time in the future or past in a variety of formats.

- ID: `get_specific_time`
- Type: Block
- Category: [Time](https://inventor.bot/docs/reference/blocks/time.md)

> If you want to get the current time, use the "Get Current Date and Time" block instead.

**Inputs**

| Name | Required | Description | Value |
| --- | --- | --- | --- |
| `year` | yes | Year value. | e.g. `"2025"` |
| `month` | yes | Month value. | e.g. `"12"` |
| `day` | yes | Day of month value. | e.g. `"10"` |
| `hour` | yes | Hour value (24h). | e.g. `"15"` |
| `minute` | yes | Minute value. | e.g. `"04"` |
| `second` | yes | Second value. | e.g. `"05"` |

**Outputs**

| Name | Description | Value |
| --- | --- | --- |
| `time_unix` | Specified time in Unix seconds. | e.g. `"1700000000"` |
| `time_unix_milli` | Specified time in Unix milliseconds. | e.g. `"1700000000000"` |
| `date_year` | Year component. | e.g. `"2025"` |
| `date_month` | Month component. | e.g. `"12"` |
| `date_month_name` | Month name. | e.g. `"December"` |
| `date_day_of_week` | Day of week (0=Sunday). | e.g. `"1"` |
| `date_day_of_month` | Day of month. | e.g. `"10"` |
| `date_day_name` | Weekday name. | e.g. `"Wednesday"` |
| `date_mm_dd_yyyy` | Date formatted as MM/DD/YYYY. | e.g. `"12/10/2025"` |
| `date_dd_mm_yyyy` | Date formatted as DD/MM/YYYY. | e.g. `"10/12/2025"` |
| `time_hours` | Hour component (24h). | e.g. `"15"` |
| `time_minutes` | Minute component. | e.g. `"04"` |
| `time_seconds` | Second component. | e.g. `"05"` |
| `time_milliseconds` | Millisecond component. | e.g. `"123"` |
| `time_hh_mm_ss` | Time formatted as HH:MM:SS. | e.g. `"15:04:05"` |
| `time_hh_mm` | Time formatted as HH:MM. | e.g. `"15:04"` |
| `time_relative` | Human-readable relative time. | e.g. `"in 1 hour"` |

**Example**

```go
specificTime := get_specific_time(Args{
	year:   2025,
	month:  12,
	day:    10,
	hour:   15,
	minute: "04",
	second: "05",
})
send_text_message(Args{
	channel_id:      trigger.channel_id,
	message_content: "Time (Unix): " + specificTime.time_unix,
})
```