Merge pull request #323 from realpython/get_time

Materials for "How to Get and Use the Current Time in Python"

Author: KateFinegan

python-get-current-time/README.md

@@ -0,0 +1,3 @@
+# How to Get and Use the Current Time in Python
+
+The code samples and supporting materials for the [corresponding tutorial](https://realpython.com/python-get-current-time/) on Real Python.

python-get-current-time/unix_time.py

@@ -0,0 +1,15 @@
+from datetime import datetime
+import time
+
+
+datetime_unixtime = datetime.now().timestamp()
+time_unixtime = time.time()
+timezone_aware_unixtime = datetime.now().astimezone().timestamp()
+
+print(
+    f"""
+{datetime_unixtime       = }
+{time_unixtime           = }
+{timezone_aware_unixtime = }
+"""
+)

python-get-current-time/with_datetime.py

@@ -0,0 +1,44 @@
+from datetime import datetime, timezone
+
+"""
+datetime.datetime.now() is preferred over:
+
+- datetime.utc.now()
+- datetime.today()
+- time.time()
+"""
+
+now = datetime.now()
+
+print(
+    f"""
+{now = }
+{now.time()         = }
+{now.day            = }
+{now.hour           = }
+{now.minute         = }
+{now.isoformat()    = }
+{now.weekday()      = }
+{now.isoweekday()   = }
+{now.isocalendar()  = }
+
+"""
+)
+
+# https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes
+print(now.strftime("%A, %B %d %Z"))
+
+
+# UTC timezone aware object
+
+now = datetime.now(timezone.utc)
+
+print(
+    f"""
+UTC timezone aware:
+{now = }
+{now.isoformat() = }
+"""
+)
+
+print(now.strftime("%A, %B %d %Z"))

python-get-current-time/with_time.py

@@ -0,0 +1,11 @@
+import time
+
+
+print(
+    f"""
+{time.time()       = }
+{time.ctime()      = }
+{time.gmtime()     = }
+{time.localtime()  = }
+"""
+)