From 1bdafab25bb8123608d95d133b2b8d238e36b179 Mon Sep 17 00:00:00 2001
From: Dom <intense.smurf@gmail.com>
Date: Mon, 29 Jun 2020 17:44:16 -0400
Subject: [PATCH] added documentation for Dates.TimeZone, Dates.UTC

see #31202
---
 stdlib/Dates/docs/src/index.md |  2 ++
 stdlib/Dates/src/types.jl      | 14 ++++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/stdlib/Dates/docs/src/index.md b/stdlib/Dates/docs/src/index.md
index b328b2212a229..4db476e41e2dc 100644
--- a/stdlib/Dates/docs/src/index.md
+++ b/stdlib/Dates/docs/src/index.md
@@ -643,6 +643,8 @@ Dates.TimeType
 Dates.DateTime
 Dates.Date
 Dates.Time
+Dates.TimeZone
+Dates.UTC
 ```
 
 ## Dates Functions
diff --git a/stdlib/Dates/src/types.jl b/stdlib/Dates/src/types.jl
index f6fd993ebfc84..05d174c3f38cf 100644
--- a/stdlib/Dates/src/types.jl
+++ b/stdlib/Dates/src/types.jl
@@ -85,7 +85,21 @@ abstract type Calendar <: AbstractTime end
 # ISOCalendar provides interpretation rules for UTInstants to civil date and time parts
 struct ISOCalendar <: Calendar end
 
+"""
+    TimeZone
+
+Geographic zone generally based on longitude determining what the time is at a certain location.
+Some time zones observe daylight savings (eg EST -> EDT).
+For implementations and more support, see the `TimeZones` package
+"""
 abstract type TimeZone end
+
+"""
+    UTC
+
+`UTC`, or Coordinated Universal Time, is the [`TimeZone`](@ref) from which all others are measured.
+It is associated with the time at 0° longitude. It is not adjusted for daylight savings.
+"""
 struct UTC <: TimeZone end
 
 """