- Как использовать модуль datetime в Python
- Как получить текущие дату и время?
- Получить текущую дату в Python
- Получить текущее время
- Компоненты datetime в Python
- Как создавать объекты даты и времени
- Timedelta
- Как вычислить разницу для двух дат
- Как вычислить разницу двух объектов datetime.time
- Как получать прошлые и будущие даты с помощью timedelta
- Другие арифметические операции с timedelta
- Часовые пояса
- Разница между DST, GMT и UTC
- Как работать с часовыми поясами
- Конвертация часовых поясов
- Другие практические примеры
- Как конвертировать строки в datetime
- Python Datetime with Timezones: Examples and Reference
- Current datetime in Timezone
- Datetime with Offset Timezone
- Add UTC Timezone to naive datetime
- Convert datetime to another timezone
Как использовать модуль datetime в Python
Datetime — важный элемент любой программы, написанной на Python. Этот модуль позволяет управлять датами и временем, представляя их в таком виде, в котором пользователи смогут их понимать.
datetime включает различные компоненты. Так, он состоит из объектов следующих типов:
Как получить текущие дату и время?
С помощью модуля Python это сделать очень просто. Сначала нужно импортировать класс datetime из модуля datetime , после чего создать объект datetime . Модуль предоставляет метод now() , который возвращает текущие дату и время с учетом локальных настроек.
import datetime
dt_now = datetime.datetime.now()
print(dt_now)Получить текущую дату в Python
Класс date можно использовать для получения или изменения объектов даты. Например, для получения текущей с учетом настроек подойдет следующее:
from datetime import date
current_date = date.today()
print(current_date)Текущая дата — 2020-11-14 в формате год-месяц-день соответственно.
Получить текущее время
Для получения текущего локального времени сперва нужно получить текущие дату и время, а затем достать из этого объекта только время с помощью метода time() :
import datetime
current_date_time = datetime.datetime.now()
current_time = current_date_time.time()
print(current_time)Компоненты datetime в Python
Модуль datetime в Python может использоваться для получения разных версий времени. Для этого нужно ознакомиться с атрибутами модуля. Используем для этого функцию dir() .
import datetime
attr = dir(datetime)
print(attr)
# ['MAXYEAR', 'MINYEAR', '__doc__', '__name__', '__package__', 'date', 'datetime',
# 'datetime_CAPI', 'time', 'timedelta', 'tzinfo']В этом руководстве речь пойдет о следующих элементах:
- date — объекты даты
- datetime — объекты даты и времени
- time — объекты времени
- timedelta — этот атрибут покрывает интервалы и используется для определения прошлых или будущих событий
- Tzinfo — этот атрибут отвечает за часовые пояса
Как создавать объекты даты и времени
Для создания объекта времени используется класс time из модуля datetime в Python. Синтаксис следующий: datetime.time(hour, minutes, seconds) .
В этом примере создается объект времени представленный следующим образом (8, 48, 45).
import datetime
timeobj= datetime.time(8,48,45)
print(timeobj)Сначала импортируется модуль datetime . После этого создается экземпляр класса (объект time ). Затем ему присваивается значение datetime.time(8, 48, 45) , где параметры 8, 48 и 45 представляют собой часы, минуты и секунды соответственно.
Для создания объекта даты нужно передать дату с использованием следующего синтаксиса:
datetime.datetime(year,month,day))
import datetime
date_obj = datetime.datetime(2020,10,17)
print(date_obj)Вернет вот такой результат:
Timedelta
timedelta представляет длительность (даты или времени). Модуль datetime включает атрибут timedelta() , который используется для управления датой в Python. Объект timedelta выглядит следующим образом:
td_object =timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)
td_object
datetime.timedelta(0)Все аргументы опциональные и их значения по умолчанию равно 0. Они могут быть целыми или числами с плавающей точкой, как положительными, так и отрицательными. Благодаря этому можно выполнять математические операции, такие как сложение, вычитание и умножение.
Как вычислить разницу для двух дат
Посмотрим на несколько примеров вычисления разницы во времени. Предположим, есть два объекта datetime :
first_date = date(2020, 10, 2) second_date = date(2020, 10, 30)
Для получения разницы нужно лишь вычесть значение одного объекта из второго:
from datetime import date
first_date = date(2020, 10, 2)
second_date = date(2020, 10, 30)
delta = second_date - first_date
print(delta)Таким образом между 2 и 30 октября 2020 года 28 дней.
Как вычислить разницу двух объектов datetime.time
С помощью timedelta нельзя выполнять манипуляции над объектами time . Например:
from datetime import datetime, timedelta
current_datetime = datetime.now()
current_time = current_datetime.time()
print("Текущее время:", current_time)
tm_after_1_hr = current_time + timedelta(hours=1)
print(tm_after_1_hr)Такой код вернет следующую ошибку:
Traceback (most recent call last): File "C:\Users\alex\AppData\Local\Programs\Python\Python38\sg_verify.py", line 6, in tm_after_1_hr = current_time + timedelta(hours=1) TypeError: unsupported operand type(s) for +: 'datetime.time' and 'datetime.timedelta'
Как получать прошлые и будущие даты с помощью timedelta
Поскольку timedelta — это длительность, то для получения прошлой или будущей даты нужно добавить объект timedelta к существующему или вычесть из него же. Вот пример нескольких уравнений, где n — это целое число, представляющее количество дней:
import datetime
current_date = datetime.datetime.today()
past_date = datetime.datetime.today() – datetime.timedelta(days=n)
future_date = datetime.datetime.today() – datetime.timedelta(days=n)Если нужно, например, получить дату за прошлые две недели, то достаточно вычесть 14 дней из текущей даты:
import datetime
past_date = datetime.datetime.today() - datetime.timedelta(days=14)
print(past_date)Предположим, вы задумали практиковать определенный навык в течение 21 дня. Для получения будущей даты нужно добавить 21 день к текущей дате:
import datetime
future_date = datetime.datetime.today() + datetime.timedelta(days=21)
print(future_date)Другие арифметические операции с timedelta
Значения даты и времени могут сравниваться для определения того, какая из них была раньше или позже. Например:
import datetime
now = datetime.time(9, 31, 0)
next_hour = datetime.time(10, 31, 0)
print('now < next_hour:', now < next_hour) today = datetime.date.today() next_week = datetime.date.today() + datetime.timedelta(days=7) print('today >next_week:', today > next_week)Часовые пояса
Пока что мы работали с datetime без учета часовых поясов и летнего времени. Но прежде чем переходить к следующим пунктам, нужно разобраться с разницей в абсолютных (naive) и относительных (aware) датах.
Абсолютные даты не содержат информацию, которая бы могла определить часовой пояс или летнее время. Однако с такими намного проще работать.
Относительные же содержат достаточно информации для определения часового пояса или отслеживания изменений из-за летнего времени.
Разница между DST, GMT и UTC
- GMT
Официальный часовой пояс, используемый в некоторых странах Европы и Африки. Он может быть представлен как в 24, так и в 12-часовом форматах. GMT используется для того, чтобы задавать местное время. Например, местное время для Берлина 2020–10–17 09:40:33.614581+02:00 GMT. Для Найроби же это — 2020–10–17 10:40:33.592608+03:00 GMT.- DST (летнее время)
Страны, которые переходят на летнее время, делают это для того, чтобы дневное время длилось как можно дольше. Во время летнего времени они переводят стрелки своих часов на час вперед и возвращаются обратно осенью.- UTC (всемирное координированное время)
Временной стандарт для часовых поясов во всем мире. Он позволяет синхронизировать время во всем мире и служит отправной точкой для остальных.Как работать с часовыми поясами
Рассмотрим, как создать простой относительный объект datetime :
import datetime
dt_now = datetime.datetime.utcnow()
print(dt_now)Эта программа возвращает объект с абсолютным значением datetime . Если же нужно сделать его абсолютным, то нужно явно указать часовой пояс. Как это сделать? В библиотеке datetime в Python нет модуля для работы с часовыми поясами. Для этого нужно использовать другие библиотеки. Одна из таких — pytz.
Предположим, нужно получить текущее время для Найроби. Для этого нужно использовать конкретный часовой пояс. Для начала можно с помощью pytz получить все существующие часовые пояса.
import pytz
pytz.all_timezones['Africa/Abidjan', 'Africa/Accra', 'Africa/Addis_Ababa', 'Africa/Nairobi']
Для получения времени в Найроби:
import pytz
import datetime
tz_nairobi = pytz.timezone("Africa/Nairobi")
dt_nairobi =datetime.datetime.now(tz_nairobi)
print(dt_nairobi)2020-11-14 17:27:31.141255+03:00
А вот так можно получить время Берлина:
import pytz
import datetime
tz_berlin = pytz.timezone("Europe/Berlin")
dt_berlin =datetime.datetime.now(tz_berlin)
print(dt_berlin)2020-11-14 15:28:20.977529+01:00
Здесь можно увидеть разницу в часовых поясах разных городов, хотя сама дата одна и та же.
Конвертация часовых поясов
При конвертации часовых поясов в первую очередь нужно помнить о том, что все атрибуты представлены в UTC. Допустим, нужно конвертировать это значение в America/New_York :
import datetime
import pytz
timezone_berlin = '2019-06-29 17:08:00'
tz_ber_obj = datetime.datetime.strptime(timezone_berlin, '%Y-%m-%d %H:%M:%S')
timezone_newyork = pytz.timezone('America/New_York')
timezone_newyork_obj = timezone_newyork.localize(tz_ber_obj)
print(timezone_newyork_obj)
print(timezone_newyork_obj.tzinfo)2019-06-29 17:08:00-04:00 America/New_York
Другие практические примеры
Всегда храните даты в UTC. Вот примеры:
import datetime
import pytz
time_now = datetime.datetime.now(pytz.utc)
print(time_now)Результат для этого кода — 2020-11-14 14:38:46.462397+00:00 , хотя локальное время может быть, например, таким 2020-11-14 16:38:46.462397+00:00 . А уже при демонстрации даты пользователю стоит использовать метод localize с местными настройками:
import datetime
import pytz
now = datetime.datetime.today()
now_utc = pytz.utc.localize(now)Вернет текущее локальное время — 2020-11-14 16:42:38.228528+00:00 .
Как конвертировать строки в datetime
strptime() в Python — это метод из модуля datetime. Вот его синтаксис:
dateobj = datetime.strptime(date_string, format)
Аргументы формата необязательные и являются строками. Предположим, нужно извлечь текущие дату и время:
import datetime
current_dt = datetime.datetime.now()
print(current_dt)Результат будет в формате ISO 8601, то есть YYYY-MM-DDTHH:MM:SS.mmmmmm — формат по умолчанию, что позволяет получать строки в едином формате.
Символ | Описание | Пример |
---|---|---|
%a | День недели, короткий вариант | Wed |
%A | Будний день, полный вариант | Wednesday |
%w | День недели числом 0-6, 0 — воскресенье | 3 |
%d | День месяца 01-31 | 31 |
%b | Название месяца, короткий вариант | Dec |
%B | Название месяца, полное название | December |
%m | Месяц числом 01-12 | 12 |
%y | Год, короткий вариант, без века | 18 |
%Y | Год, полный вариант | 2018 |
%H | Час 00-23 | 17 |
%I | Час 00-12 | 05 |
%p | AM/PM | PM |
%M | Минута 00-59 | 41 |
%S | Секунда 00-59 | 08 |
%f | Микросекунда 000000-999999 | 548513 |
%z | Разница UTC | +0100 |
%Z | Часовой пояс | CST |
%j | День в году 001-366 | 365 |
%U | Неделя числом в году, Воскресенье первый день недели, 00-53 | 52 |
%W | Неделя числом в году, Понедельник первый день недели, 00-53 | 52 |
%c | Локальная версия даты и времени | Mon Dec 31 17:41:00 2018 |
%x | Локальная версия даты | 12/31/18 |
%X | Локальная версия времени | 17:41:00 |
%% | Символ “%” | % |
Python Datetime with Timezones: Examples and Reference
To get the current timestamp in UTC timezone, use datetime.now() passing timezone.utc :
from datetime import datetime, timezone dt = datetime.now(timezone.utc) dt # datetime.datetime(2021, 1, 3, 21, 14, 51, 547415, tzinfo=datetime.timezone.utc)
Current datetime in Timezone
from datetime import datetime, timezone, timedelta dt = datetime.now(timezone(timedelta(hours=-3))) dt # datetime.datetime(2021, 1, 3, 18, 29, 54, 46852, tzinfo=datetime.timezone(datetime.timedelta(-1, 75600)))
Datetime with Offset Timezone
Timezones can be defined by the offset with respect to UTC.
from datetime import datetime, timezone, timedelta # UTC+03:00 tz = timezone(timedelta(hours=3)) # May 10, 2016 at 12:30:00, on UTC-03:00 dt = datetime(2016,5,10,12,30,0,0, tzinfo=tz) dt # datetime.datetime(2016, 5, 10, 12, 30, tzinfo=datetime.timezone(datetime.timedelta(0, 10800)))
Add UTC Timezone to naive datetime
In other words, attach Timezone information to datetime objects that were created without timezone information, without adjusting the time
from datetime import datetime, timezone # this is a naive datetime without timezone information naive_dt = datetime.now() naive_dt # datetime.datetime(2021, 1, 3, 18, 33, 50, 631654) dt_with_tz = naive_dt.replace(tzinfo=timezone.utc) dt_with_tz # datetime.datetime(2021, 1, 3, 18, 33, 50, 631654, tzinfo=datetime.timezone.utc)
Convert datetime to another timezone
from datetime import datetime, timezone, timedelta # 21:36 in UTC base_dt = datetime.now(timezone.utc) base_dt # datetime.datetime(2021, 1, 3, 21, 36, 6, 339737, tzinfo=datetime.timezone.utc) # becomes 23:36 in UTC+02:00 dt_in_utc_plus_2 = base_dt.astimezone(timezone(timedelta(hours=2))) dt_in_utc_plus_2 # datetime.datetime(2021, 1, 3, 23, 36, 6, 339737, tzinfo=datetime.timezone(datetime.timedelta(0, 7200)))