API 文档

一个简单而强大的日期图片生成 API，支持多种格式和样式自定义。

在线示例

通过以下示例了解 API 的各种用法和效果

基础用法

最基本的使用方式，展示了默认效果和一些简单的自定义选项。

/api/date-image

/api/date-image?color=purple&background=pink

/api/date-image?fontSize=72&padding=32

/api/date-image?radius=16&background=%23f0f0f0

/api/date-image?format=YYYY-MM-DD%20HH:mm:ss&fontSize=56&padding=24

参数说明

format

string•默认值: YYYY-MM-DD

YYYY-MM-DD HH:mm:ss

日期格式，支持 Day.js 的所有格式化选项

type

string•默认值: svg

png

图片格式，支持 svg/png/jpg/webp

fontSize

number•默认值: 48

64

字体大小，单位像素

padding

number•默认值: 20

32

内边距，单位像素

radius

number•默认值: 0

8

圆角大小，单位像素

color

string•默认值: #000000

#FF0000

文字颜色，支持任何有效的 CSS 颜色值

background

string•默认值: transparent

#FFFFFF

背景颜色，支持任何有效的 CSS 颜色值

utc

string•默认值: +08:00

-04:00

UTC 偏移量，格式如 +08:00、-05:30

快速开始

HTML 使用

<img src="/api/date-image" alt="当前日期" />

Markdown 使用

![当前日期](/api/date-image)

格式化参考

支持所有 Day.js 的格式化字符串，以下是常用的格式化标记

YYYY四位数年份2024

MM两位数月份03

DD两位数日期09

HH24小时制小时13

hh12小时制小时01

mm两位数分钟05

ss两位数秒钟30

A上午/下午AM/PM

ZUTC偏移+08:00

[文本]转义文本[UTC]Z

更多格式化选项请参考 Day.js 文档

缓存说明

所有图片都使用 HTTP 缓存机制，缓存时间根据日期格式动态计算：

秒级格式缓存 1 秒HH:mm:ss

分钟级格式缓存到下一分钟HH:mm

小时级格式缓存到下一小时HH:00

天级格式缓存到明天 0 点MM-DD

月级格式缓存到下月 1 日YYYY-MM

年级格式缓存到明年 1 月 1 日YYYY

浏览器会根据 Cache-Control 头自动处理缓存，无需手动干预。