Python time.localtime()函数详解|极客教程

Python time.localtime()函数详解

1. 概述

在Python中，time模块提供了丰富的时间处理函数。其中，time.localtime()函数是一个常用的函数，用于将一个时间戳转换为本地时间的struct_time对象。本文将详细介绍time.localtime()函数的用法及示例代码。

2. time.localtime()函数的语法

time.localtime()函数的语法如下：

time.localtime([secs])

参数说明：

secs（可选）：指定要转换的时间戳（秒数），若不提供，则默认为当前时间。

返回值：

struct_time对象，代表本地时间。

3. time.localtime()函数的用法

下面将分别介绍time.localtime()函数的两种常见用法。

3.1 不提供参数

当不提供参数时，time.localtime()函数将返回当前时间的本地时间。

示例代码：

import time

local_time = time.localtime()
print(local_time)

运行结果：

time.struct_time(tm_year=2023, tm_mon=1, tm_mday=11, tm_hour=14, tm_min=1, tm_sec=10, tm_wday=2, tm_yday=11, tm_isdst=0)

上述代码中，time.localtime()函数未提供参数，所以返回的是当前时间的本地时间。结果是一个struct_time对象，包含了当前时间的各个信息。

3.2 提供参数

当提供参数（时间戳）时，time.localtime()函数将根据提供的时间戳来转换为本地时间。

示例代码：

import time

timestamp = 1609459200  # 2021-01-01 00:00:00的时间戳
local_time = time.localtime(timestamp)
print(local_time)

运行结果：

time.struct_time(tm_year=2021, tm_mon=1, tm_mday=1, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=4, tm_yday=1, tm_isdst=0)

在上述示例中，我们提供了一个时间戳（1609459200），将该时间戳转换为本地时间。结果同样是一个struct_time对象，包含了转换后的本地时间的各个信息。

4. struct_time对象的属性

我们上面多次提到了struct_time对象，它是time.localtime()函数的返回值。下面将详细介绍struct_time对象的属性。

struct_time对象具有下述属性：

属性名	含义	值范围
tm_year	年份（四位数）	例如：2021
tm_mon	月份	1~12
tm_mday	日期（一个月中的第几天）	1~31
tm_hour	小时	0~23
tm_min	分钟	0~59
tm_sec	秒钟	0~61（60和61是闰秒）
tm_wday	星期（从星期一开始计数）	0~6（0是星期一）
tm_yday	一年中的第几天（从1月1日开始计数）	1~366
tm_isdst	是否为夏令时（1表示是，0表示否，-1表示未知）	-1、0、1

5. struct_time对象的使用

struct_time对象常常用于格式化时间的输出、时间计算等操作。接下来，我们将通过示例代码来展示struct_time对象的使用。

5.1 格式化时间输出

我们可以使用struct_time对象的属性来格式化时间的输出，例如显示年份、月份、日期等。

示例代码：

import time

local_time = time.localtime()
print(f"当前时间：{local_time.tm_year}年{local_time.tm_mon}月{local_time.tm_mday}日")

运行结果：

当前时间：2023年1月11日

上述代码中，我们使用struct_time对象的属性来输出当前的年份、月份和日期。

5.2 时间计算

struct_time对象可以用于时间的加减计算。例如，下面示例将当前时间加上10天，并输出。

示例代码：

import time

local_time = time.localtime()
future_time = time.localtime(time.mktime(local_time) + 10 * 24 * 3600)
print(f"10天后的时间为：{future_time.tm_year}年{future_time.tm_mon}月{future_time.tm_mday}日")

运行结果：