/DateTime

Date and time status bar information for Visual Studio Code.

Primary LanguageTypeScript

Date & Time

Displays a clock and date information in the status bar.

Configuration Options

Option Default Description Example
dateTime.showOnStartup true Show date & time on startup.
dateTime.use24HourClock true Use a 24 hour clock. 18:43
dateTime.showAMPM false Show AM/PM. 7:43 PM
dateTime.showDayOfWeek false Show the day of the week. Fri 1 Jul
dateTime.showDayOfMonth false Show the day of the month. Fri 1 Jul
dateTime.showMonth false Show the month. Fri 1 Jul
dateTime.showHours true Show hours. 18:43
dateTime.showMinutes true Show minutes. 18:43
dateTime.showSeconds false Show seconds. 18:43:12
dateTime.padDays false Pad the day of the month with a leading 0. Fri 01 Jul
dateTime.padHours true Pad hours with a leading 0. 09:43
dateTime.padMinutes true Pad minutes with a leading 0. 18:03
dateTime.padSeconds true Pad seconds with a leading 0. 18:43:04
dateTime.locale null Date & time locale. es-us
dateTime.timeZone null Time zone. Europe/Paris
dateTime.flashTimeSeparators false Flash the time separators.
dateTime.timeSeparator : Time separator character.
dateTime.timeSeparatorOff Flashing time separator character.
dateTime.customFormat null Use a custom date & time format.
dateTime.clipboardFormat null Use a custom date & time format when copying.
dateTime.fractionalPrecision null Update interval divisor for fractional seconds.
dateTime.statusBarAlignment right Status bar alignment, left or right. left
dateTime.statusBarPriority null Status bar priority. Higher means more to the left. 10
dateTime.displayPrefix null Prepend a string to the displayed time. Time:
dateTime.displaySuffix null Append a string to the displayed time. .

Example usage

// 28 Feb 18:47
"dateTime.showDayOfMonth": true,
"dateTime.showMonth": true

// 9:30 AM
"dateTime.use24HourClock": false,
"dateTime.showAMPM": true

Custom date & time format

Custom date & time formats can be specified using the following format:

Token Output
Month M 1 2 ... 11 12
Mo 1st 2nd ... 11th 12th
MM 01 02 ... 11 12
MMM Jan Feb ... Nov Dec
MMMM January February ... November December
Quarter Q 1 2 3 4
Qo 1st 2nd 3rd 4th
Day of Month D 1 2 ... 30 31
Do 1st 2nd ... 30th 31st
DD 01 02 ... 30 31
Day of Year DDD 1 2 ... 364 365
DDDo 1st 2nd ... 364th 365th
DDDD 001 002 ... 364 365
Day of Week d 0 1 ... 5 6
do 0th 1st ... 5th 6th
dd Su Mo ... Fr Sa
ddd Sun Mon ... Fri Sat
dddd Sunday Monday ... Friday Saturday
Day of Week (Locale) e 0 1 ... 5 6
eo 0th 1st ... 5th 6th
Day of Week (ISO) E 1 2 ... 6 7
Eo 1st 2nd ... 6th 7th
Week of Year w 1 2 ... 52 53
wo 1st 2nd ... 52nd 53rd
ww 01 02 ... 52 53
Week of Year (ISO) W 1 2 ... 52 53
Wo 1st 2nd ... 52nd 53rd
WW 01 02 ... 52 53
Year YY 70 71 ... 29 30
YYYY 1970 1971 ... 2029 2030
Week Year gg 70 71 ... 29 30
gggg 1970 1971 ... 2029 2030
Week Year (ISO) GG 70 71 ... 29 30
GGGG 1970 1971 ... 2029 2030
AM/PM A AM PM
a am pm
Hour H 0 1 ... 22 23
HH 00 01 ... 22 23
h 1 2 ... 11 12
hh 01 02 ... 11 12
Minute m 0 1 ... 58 59
mm 00 01 ... 58 59
Second s 0 1 ... 58 59
ss 00 01 ... 58 59
Fractional Second S 0 1 ... 8 9
SS 00 01 ... 98 99
SSS 000 001 ... 998 999
Unix Timestamp X 1360013296
Unix Millisecond Timestamp x 1360013296123
Abbreviated Timezone z EST
Unabbreviated Timezone zzz Eastern Standard Time
Escape [...] Text between [ and ] is escaped

Example usage

// Friday, January the 1st, 2016
"dateTime.customFormat": "dddd, MMMM [the] Do, YYYY"

// 2016-01-01 10:12:03
"dateTime.customFormat": "YYYY-MM-DD HH:mm:ss"

Date & time locale

The locale can be one of:

  • af - Afrikaans
  • am - Amharic
  • ar-dz - Arabic (Algeria)
  • ar-iq - Arabic (Iraq)
  • ar-kw - Arabic (Kuwait)
  • ar-ly - Arabic (Lybia)
  • ar-ma - Arabic (Morocco)
  • ar-sa - Arabic (Saudi Arabia)
  • ar-tn - Arabic (Tunisia)
  • ar - Arabic
  • az - Azerbaijani
  • be - Belarusian
  • bg - Bulgarian
  • bi - Bislama
  • bm - Bambara
  • bn-bd - Bengali (Bangladesh)
  • bn - Bengali
  • bo - Tibetan
  • br - Breton
  • bs - Bosnian
  • ca - Catalan
  • cs - Czech
  • cv - Chuvash
  • cy - Welsh
  • da - Danish
  • de-at - German (Austria)
  • de-ch - German (Switzerland)
  • de - German
  • dv - Maldivian
  • el - Greek
  • en-au - English (Australia)
  • en-ca - English (Canada)
  • en-gb - English (United Kingdom)
  • en-ie - English (Ireland)
  • en-il - English (Israel)
  • en-in - English (India)
  • en-nz - English (New Zealand)
  • en-sg - English (Singapore)
  • en-tt - English (Trinidad & Tobago)
  • en - English
  • eo - Esperanto
  • es-do - Spanish (Dominican Republic)
  • es-mx - Spanish (Mexico)
  • es-PR - Spanish (Puerto Rico)
  • es-us - Spanish (United States)
  • es - Spanish
  • et - Estonian
  • eu - Basque
  • fa - Persian
  • fi - Finnish
  • fo - Faroese
  • fr-ca - French (Canada)
  • fr-ch - French (Switzerland)
  • fr - French
  • fy - Frisian
  • ga - Irish or Irish Gaelic
  • gd - Scottish Gaelic
  • gl - Galician
  • gom-latn - Konkani Latin script
  • gu - Gujarati
  • he - Hebrew
  • hi - Hindi
  • hr - Croatian
  • ht - Haitian Creole (Haiti)
  • hu - Hungarian
  • hy-am - Armenian
  • id - Indonesian
  • is - Icelandic
  • it-ch - Italian (Switzerland)
  • it - Italian
  • ja - Japanese
  • jv - Javanese
  • ka - Georgian
  • kk - Kazakh
  • km - Cambodian
  • kn - Kannada
  • ko - Korean
  • ku - Kurdish
  • ky - Kyrgyz
  • lb - Luxembourgish
  • lo - Lao
  • lt - Lithuanian
  • lv - Latvian
  • me - Montenegrin
  • mi - Maori
  • mk - Macedonian
  • ml - Malayalam
  • mn - Mongolian
  • mr - Marathi
  • ms-my - Malay
  • ms - Malay
  • mt - Maltese (Malta)
  • my - Burmese
  • nb - Norwegian Bokmål
  • ne - Nepalese
  • nl-be - Dutch (Belgium)
  • nl - Dutch
  • nn - Nynorsk
  • oc-lnc - Occitan, lengadocian dialecte
  • pa-in - Punjabi (India)
  • pl - Polish
  • pt-br - Portuguese (Brazil)
  • pt - Portuguese
  • rn - Kirundi
  • ro - Romanian
  • ru - Russian
  • rw - Kinyarwanda (Rwanda)
  • sd - Sindhi
  • se - Northern Sami
  • si - Sinhalese
  • sk - Slovak
  • sl - Slovenian
  • sq - Albanian
  • sr-cyrl - Serbian Cyrillic
  • sr - Serbian
  • ss - siSwati
  • sv-fi - Finland Swedish
  • sv - Swedish
  • sw - Swahili
  • ta - Tamil
  • te - Telugu
  • tet - Tetun Dili (East Timor)
  • tg - Tajik
  • th - Thai
  • tk - Turkmen
  • tl-ph - Tagalog (Philippines)
  • tlh - Klingon
  • tr - Turkish
  • tzl - Talossan
  • tzm-latn - Central Atlas Tamazight Latin
  • tzm - Central Atlas Tamazight
  • ug-cn - Uyghur (China)
  • uk - Ukrainian
  • ur - Urdu
  • uz-latn - Uzbek Latin
  • uz - Uzbek
  • vi - Vietnamese
  • yo - Yoruba Nigeria
  • zh-cn - Chinese (China)
  • zh-hk - Chinese (Hong Kong)
  • zh-tw - Chinese (Taiwan)
  • zh - Chinese

Time Zones

The time zone can be one of:

  • Africa/Abidjan
  • Africa/Accra
  • Africa/Addis_Ababa
  • Africa/Algiers
  • Africa/Asmera
  • Africa/Bamako
  • Africa/Bangui
  • Africa/Banjul
  • Africa/Bissau
  • Africa/Blantyre
  • Africa/Brazzaville
  • Africa/Bujumbura
  • Africa/Cairo
  • Africa/Casablanca
  • Africa/Ceuta
  • Africa/Conakry
  • Africa/Dakar
  • Africa/Dar_es_Salaam
  • Africa/Djibouti
  • Africa/Douala
  • Africa/El_Aaiun
  • Africa/Freetown
  • Africa/Gaborone
  • Africa/Harare
  • Africa/Johannesburg
  • Africa/Juba
  • Africa/Kampala
  • Africa/Khartoum
  • Africa/Kigali
  • Africa/Kinshasa
  • Africa/Lagos
  • Africa/Libreville
  • Africa/Lome
  • Africa/Luanda
  • Africa/Lubumbashi
  • Africa/Lusaka
  • Africa/Malabo
  • Africa/Maputo
  • Africa/Maseru
  • Africa/Mbabane
  • Africa/Mogadishu
  • Africa/Monrovia
  • Africa/Nairobi
  • Africa/Ndjamena
  • Africa/Niamey
  • Africa/Nouakchott
  • Africa/Ouagadougou
  • Africa/Porto-Novo
  • Africa/Sao_Tome
  • Africa/Tripoli
  • Africa/Tunis
  • Africa/Windhoek
  • America/Adak
  • America/Anchorage
  • America/Anguilla
  • America/Antigua
  • America/Araguaina
  • America/Argentina/La_Rioja
  • America/Argentina/Rio_Gallegos
  • America/Argentina/Salta
  • America/Argentina/San_Juan
  • America/Argentina/San_Luis
  • America/Argentina/Tucuman
  • America/Argentina/Ushuaia
  • America/Aruba
  • America/Asuncion
  • America/Bahia
  • America/Bahia_Banderas
  • America/Barbados
  • America/Belem
  • America/Belize
  • America/Blanc-Sablon
  • America/Boa_Vista
  • America/Bogota
  • America/Boise
  • America/Buenos_Aires
  • America/Cambridge_Bay
  • America/Campo_Grande
  • America/Cancun
  • America/Caracas
  • America/Catamarca
  • America/Cayenne
  • America/Cayman
  • America/Chicago
  • America/Chihuahua
  • America/Coral_Harbour
  • America/Cordoba
  • America/Costa_Rica
  • America/Creston
  • America/Cuiaba
  • America/Curacao
  • America/Danmarkshavn
  • America/Dawson
  • America/Dawson_Creek
  • America/Denver
  • America/Detroit
  • America/Dominica
  • America/Edmonton
  • America/Eirunepe
  • America/El_Salvador
  • America/Fort_Nelson
  • America/Fortaleza
  • America/Glace_Bay
  • America/Godthab
  • America/Goose_Bay
  • America/Grand_Turk
  • America/Grenada
  • America/Guadeloupe
  • America/Guatemala
  • America/Guayaquil
  • America/Guyana
  • America/Halifax
  • America/Havana
  • America/Hermosillo
  • America/Indiana/Knox
  • America/Indiana/Marengo
  • America/Indiana/Petersburg
  • America/Indiana/Tell_City
  • America/Indiana/Vevay
  • America/Indiana/Vincennes
  • America/Indiana/Winamac
  • America/Indianapolis
  • America/Inuvik
  • America/Iqaluit
  • America/Jamaica
  • America/Jujuy
  • America/Juneau
  • America/Kentucky/Monticello
  • America/Kralendijk
  • America/La_Paz
  • America/Lima
  • America/Los_Angeles
  • America/Louisville
  • America/Lower_Princes
  • America/Maceio
  • America/Managua
  • America/Manaus
  • America/Marigot
  • America/Martinique
  • America/Matamoros
  • America/Mazatlan
  • America/Mendoza
  • America/Menominee
  • America/Merida
  • America/Metlakatla
  • America/Mexico_City
  • America/Miquelon
  • America/Moncton
  • America/Monterrey
  • America/Montevideo
  • America/Montreal
  • America/Montserrat
  • America/Nassau
  • America/New_York
  • America/Nipigon
  • America/Nome
  • America/Noronha
  • America/North_Dakota/Beulah
  • America/North_Dakota/Center
  • America/North_Dakota/New_Salem
  • America/Ojinaga
  • America/Panama
  • America/Pangnirtung
  • America/Paramaribo
  • America/Phoenix
  • America/Port-au-Prince
  • America/Port_of_Spain
  • America/Porto_Velho
  • America/Puerto_Rico
  • America/Punta_Arenas
  • America/Rainy_River
  • America/Rankin_Inlet
  • America/Recife
  • America/Regina
  • America/Resolute
  • America/Rio_Branco
  • America/Santa_Isabel
  • America/Santarem
  • America/Santiago
  • America/Santo_Domingo
  • America/Sao_Paulo
  • America/Scoresbysund
  • America/Sitka
  • America/St_Barthelemy
  • America/St_Johns
  • America/St_Kitts
  • America/St_Lucia
  • America/St_Thomas
  • America/St_Vincent
  • America/Swift_Current
  • America/Tegucigalpa
  • America/Thule
  • America/Thunder_Bay
  • America/Tijuana
  • America/Toronto
  • America/Tortola
  • America/Vancouver
  • America/Whitehorse
  • America/Winnipeg
  • America/Yakutat
  • America/Yellowknife
  • Antarctica/Casey
  • Antarctica/Davis
  • Antarctica/DumontDUrville
  • Antarctica/Macquarie
  • Antarctica/Mawson
  • Antarctica/McMurdo
  • Antarctica/Palmer
  • Antarctica/Rothera
  • Antarctica/Syowa
  • Antarctica/Troll
  • Antarctica/Vostok
  • Arctic/Longyearbyen
  • Asia/Aden
  • Asia/Almaty
  • Asia/Amman
  • Asia/Anadyr
  • Asia/Aqtau
  • Asia/Aqtobe
  • Asia/Ashgabat
  • Asia/Atyrau
  • Asia/Baghdad
  • Asia/Bahrain
  • Asia/Baku
  • Asia/Bangkok
  • Asia/Barnaul
  • Asia/Beirut
  • Asia/Bishkek
  • Asia/Brunei
  • Asia/Calcutta
  • Asia/Chita
  • Asia/Choibalsan
  • Asia/Colombo
  • Asia/Damascus
  • Asia/Dhaka
  • Asia/Dili
  • Asia/Dubai
  • Asia/Dushanbe
  • Asia/Famagusta
  • Asia/Gaza
  • Asia/Hebron
  • Asia/Hong_Kong
  • Asia/Hovd
  • Asia/Irkutsk
  • Asia/Jakarta
  • Asia/Jayapura
  • Asia/Jerusalem
  • Asia/Kabul
  • Asia/Kamchatka
  • Asia/Karachi
  • Asia/Katmandu
  • Asia/Khandyga
  • Asia/Krasnoyarsk
  • Asia/Kuala_Lumpur
  • Asia/Kuching
  • Asia/Kuwait
  • Asia/Macau
  • Asia/Magadan
  • Asia/Makassar
  • Asia/Manila
  • Asia/Muscat
  • Asia/Nicosia
  • Asia/Novokuznetsk
  • Asia/Novosibirsk
  • Asia/Omsk
  • Asia/Oral
  • Asia/Phnom_Penh
  • Asia/Pontianak
  • Asia/Pyongyang
  • Asia/Qatar
  • Asia/Qostanay
  • Asia/Qyzylorda
  • Asia/Rangoon
  • Asia/Riyadh
  • Asia/Saigon
  • Asia/Sakhalin
  • Asia/Samarkand
  • Asia/Seoul
  • Asia/Shanghai
  • Asia/Singapore
  • Asia/Srednekolymsk
  • Asia/Taipei
  • Asia/Tashkent
  • Asia/Tbilisi
  • Asia/Tehran
  • Asia/Thimphu
  • Asia/Tokyo
  • Asia/Tomsk
  • Asia/Ulaanbaatar
  • Asia/Urumqi
  • Asia/Ust-Nera
  • Asia/Vientiane
  • Asia/Vladivostok
  • Asia/Yakutsk
  • Asia/Yekaterinburg
  • Asia/Yerevan
  • Atlantic/Azores
  • Atlantic/Bermuda
  • Atlantic/Canary
  • Atlantic/Cape_Verde
  • Atlantic/Faeroe
  • Atlantic/Madeira
  • Atlantic/Reykjavik
  • Atlantic/South_Georgia
  • Atlantic/St_Helena
  • Atlantic/Stanley
  • Australia/Adelaide
  • Australia/Brisbane
  • Australia/Broken_Hill
  • Australia/Currie
  • Australia/Darwin
  • Australia/Eucla
  • Australia/Hobart
  • Australia/Lindeman
  • Australia/Lord_Howe
  • Australia/Melbourne
  • Australia/Perth
  • Australia/Sydney
  • Europe/Amsterdam
  • Europe/Andorra
  • Europe/Astrakhan
  • Europe/Athens
  • Europe/Belgrade
  • Europe/Berlin
  • Europe/Bratislava
  • Europe/Brussels
  • Europe/Bucharest
  • Europe/Budapest
  • Europe/Busingen
  • Europe/Chisinau
  • Europe/Copenhagen
  • Europe/Dublin
  • Europe/Gibraltar
  • Europe/Guernsey
  • Europe/Helsinki
  • Europe/Isle_of_Man
  • Europe/Istanbul
  • Europe/Jersey
  • Europe/Kaliningrad
  • Europe/Kiev
  • Europe/Kirov
  • Europe/Lisbon
  • Europe/Ljubljana
  • Europe/London
  • Europe/Luxembourg
  • Europe/Madrid
  • Europe/Malta
  • Europe/Mariehamn
  • Europe/Minsk
  • Europe/Monaco
  • Europe/Moscow
  • Europe/Oslo
  • Europe/Paris
  • Europe/Podgorica
  • Europe/Prague
  • Europe/Riga
  • Europe/Rome
  • Europe/Samara
  • Europe/San_Marino
  • Europe/Sarajevo
  • Europe/Saratov
  • Europe/Simferopol
  • Europe/Skopje
  • Europe/Sofia
  • Europe/Stockholm
  • Europe/Tallinn
  • Europe/Tirane
  • Europe/Ulyanovsk
  • Europe/Uzhgorod
  • Europe/Vaduz
  • Europe/Vatican
  • Europe/Vienna
  • Europe/Vilnius
  • Europe/Volgograd
  • Europe/Warsaw
  • Europe/Zagreb
  • Europe/Zaporozhye
  • Europe/Zurich
  • Indian/Antananarivo
  • Indian/Chagos
  • Indian/Christmas
  • Indian/Cocos
  • Indian/Comoro
  • Indian/Kerguelen
  • Indian/Mahe
  • Indian/Maldives
  • Indian/Mauritius
  • Indian/Mayotte
  • Indian/Reunion
  • Pacific/Apia
  • Pacific/Auckland
  • Pacific/Bougainville
  • Pacific/Chatham
  • Pacific/Easter
  • Pacific/Efate
  • Pacific/Enderbury
  • Pacific/Fakaofo
  • Pacific/Fiji
  • Pacific/Funafuti
  • Pacific/Galapagos
  • Pacific/Gambier
  • Pacific/Guadalcanal
  • Pacific/Guam
  • Pacific/Honolulu
  • Pacific/Johnston
  • Pacific/Kiritimati
  • Pacific/Kosrae
  • Pacific/Kwajalein
  • Pacific/Majuro
  • Pacific/Marquesas
  • Pacific/Midway
  • Pacific/Nauru
  • Pacific/Niue
  • Pacific/Norfolk
  • Pacific/Noumea
  • Pacific/Pago_Pago
  • Pacific/Palau
  • Pacific/Pitcairn
  • Pacific/Ponape
  • Pacific/Port_Moresby
  • Pacific/Rarotonga
  • Pacific/Saipan
  • Pacific/Tahiti
  • Pacific/Tarawa
  • Pacific/Tongatapu
  • Pacific/Truk
  • Pacific/Wake
  • Pacific/Wallis