mirror of
https://github.com/JanDeDobbeleer/oh-my-posh.git
synced 2024-09-20 13:37:31 -07:00
90 lines
2.2 KiB
Plaintext
90 lines
2.2 KiB
Plaintext
---
|
|
id: time
|
|
title: Time
|
|
sidebar_label: Time
|
|
---
|
|
|
|
## What
|
|
|
|
Show the current timestamp.
|
|
|
|
## Sample Configuration
|
|
|
|
```json
|
|
{
|
|
"type": "time",
|
|
"style": "plain",
|
|
"foreground": "#007ACC",
|
|
"properties": {
|
|
"time_format": "15:04:05"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Properties
|
|
|
|
- time_format: `string` - format to use, follows the [golang standard][format] - defaults to `15:04:05`
|
|
|
|
## Template ([info][templates])
|
|
|
|
:::note default template
|
|
|
|
``` template
|
|
{{ .CurrentDate | date .Format }}
|
|
```
|
|
|
|
:::
|
|
|
|
### Properties
|
|
|
|
- `.Format`: `string` - The time format (set via `time_format`)
|
|
- `.CurrentDate`: `time` - The time to display (testing purpose)
|
|
|
|
## Standard time and date formats
|
|
|
|
- January 2, 2006 **Date**
|
|
- 01/02/06
|
|
- Jan-02-06
|
|
- 15:04:05 **Time**
|
|
- 3:04:05 PM
|
|
- Jan _2 15:04:05 **Timestamp**
|
|
- Jan _2 15:04:05.000000 **with microseconds**
|
|
- 2006-01-02T15:04:05-0700 **ISO 8601 (RFC 3339)**
|
|
- 2006-01-02
|
|
- 15:04:05
|
|
- 02 Jan 06 15:04 MST **RFC 822**
|
|
- 02 Jan 06 15:04 -0700 **with numeric zone**
|
|
- Mon, 02 Jan 2006 15:04:05 MST 27e95cb
|
|
- Mon, 02 Jan 2006 15:04:05 -0700 **with numeric zone**
|
|
|
|
### The following predefined date and timestamp format constants are also available
|
|
|
|
- ANSIC = "Mon Jan _2 15:04:05 2006"
|
|
- UnixDate = "Mon Jan _2 15:04:05 MST 2006"
|
|
- RubyDate = "Mon Jan 02 15:04:05 -0700 2006"
|
|
- RFC822 = "02 Jan 06 15:04 MST"
|
|
- RFC822Z = "02 Jan 06 15:04 -0700"
|
|
- RFC850 = "Monday, 02-Jan-06 15:04:05 MST"
|
|
- RFC1123 = "Mon, 02 Jan 2006 15:04:05 MST"
|
|
- RFC1123Z = "Mon, 02 Jan 2006 15:04:05 -0700"
|
|
- RFC3339 = "2006-01-02T15:04:05Z07:00"
|
|
- RFC3339Nano = "2006-01-02T15:04:05.999999999Z07:00"
|
|
- Kitchen = "3:04PM"
|
|
// Useful time stamps.
|
|
- Stamp = "Jan _2 15:04:05"
|
|
- StampMilli = "Jan _2 15:04:05.000"
|
|
- StampMicro = "Jan _2 15:04:05.000000"
|
|
- StampNano = "Jan _2 15:04:05.000000000"
|
|
|
|
## Examples
|
|
|
|
To display the time in multiple time zones, using [Sprig's Date Functions][sprig-date]:
|
|
|
|
```text
|
|
{{ .CurrentDate | date .Format }} {{ dateInZone "15:04Z" .CurrentDate "UTC" }}
|
|
```
|
|
|
|
[templates]: /docs/configuration/templates
|
|
[format]: https://yourbasic.org/golang/format-parse-string-time-date-example/
|
|
[sprig-date]: https://masterminds.github.io/sprig/date.html
|