Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-smartpage
wecomcli-smartpage
Verified何时用:企业微信智能文档/智能主页/smartpage 相关诉求(含 doc.weixin.qq.com/smartpage/ 或 page.weixin.qq.com/smartpage/ 链接),或泛指「创建/写/整理文档」的企微诉求时使用;纯本地文档默认走本地工具。能力:新建/导入(.md)、读取、修改内容(整页重写/局部编辑/增删子页面)、上传附件、搭建带看板/图表的数据系统页面与信息收集表单、获取内置智能表格。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.5 KB |
| references/data-driven-pages.md | markdown | 4.1 KB |
| references/formula-reference.md | markdown | 6.9 KB |
| references/formula/arraylist.md | markdown | 10.7 KB |
| references/formula/datetime.md | markdown | 7.5 KB |
| references/formula/logic.md | markdown | 7.3 KB |
| references/formula/math.md | markdown | 8.5 KB |
| references/formula/operators.md | markdown | 4.8 KB |
| references/formula/pageblock.md | markdown | 3.4 KB |
| references/formula/templates.md | markdown | 11.9 KB |
| references/formula/text.md | markdown | 9.3 KB |
| references/formula/user.md | markdown | 607 B |
| references/mdx-syntax.md | markdown | 27.4 KB |
| references/smartpage-edit.md | markdown | 28.8 KB |
references/formula/datetime.md
View on GitHub# 日期时间公式函数(`DATE`, `DATEDIF`, `DATEVALUE`, `DAY`, `HOUR`, `MINUTE`, `MONTH`, `NETWORKDAYS`, `NOW`, `SECOND`, `TODAY`, `WEEKDAY`, `WEEKNUM`, `WORKDAY`, `YEAR`)
> 用于获取当前日期、日期计算、日期差值、工作日计算等日期时间处理,适用于倒计时显示、工龄计算、截止日期判断等场景。
---
## DATE - 构造日期
**表达式**: `DATE(年, 月, 日)`
**函数说明**: 将代表年、月、日的数字转换为日期。
**参数说明**:
- 年:必需,年参数的值可以包含一到四位数字
- 月:必需,一个正整数或负整数,表示一年中从1月至12月(一月到十二月)的各个月
- 日:必需,一个正整数或负整数,表示一月中从01日到31日的各天
**示例**:
```
DATE(2026,04,18) => 2026/4/18
DATE(2026, 1, 1)
```
---
## DATEDIF - 日期差
**表达式**: `DATEDIF(起始日期, 结束日期, 单位)`
**函数说明**: 计算起始日期和结束日期之间的天数、月数或年数。
**参数说明**:
- 起始日期:必需,计算中要使用的开始日期。必须是以下一种:日期格式的列、返回日期类型的函数、或数字
- 结束日期:必需,计算中要使用的结束日期。必须是以下一种:日期格式的列、返回日期类型的函数、或数字
- 单位:必需,某种时间单位的缩写字符串。例如, "Y"代表年数、"M" 代表月数、"D"代表天数、"MD"代表同月间隔天数、"YM"代表同年间隔月数、"YD"代表同年间隔天数
**示例**:
```
DATEDIF("2026/4/10","2026/4/18","D") =>8
DATEDIF([入职日期], TODAY(), "Y") // 计算工龄(年)
DATEDIF([开始日期], [结束日期], "D") // 计算项目持续天数
DATEDIF([开始日期], [结束日期], "M") // 计算相差月数
```
---
## DATEVALUE - 日期值转换
**表达式**: `DATEVALUE(日期字符串)`
**函数说明**: 将日期字符串转换为数字。数字代表是从距离1900年1月1日的天数。
**参数说明**: 日期字符串:必需。代表采用日期格式的日期文本,或是对包含这种文本的字段
**示例**:
```
DATEVALUE("2026/04/18") => 46130
DATEVALUE("2026-01-01")
```
---
## DAY - 获取日期
**表达式**: `DAY(日期)`
**函数说明**: 获取日期(或转换为数值的日期)对应的日。
**参数说明**: 日期:必需,从中提取具体几号的日期
**示例**:
```
DAY("2026-4-20 10:30:55") => 20
DAY([开工日期])
```
---
## HOUR - 获取小时
**表达式**: `HOUR(时间)`
**函数说明**: 获取时间(或转换为数值的时间)的小时数。
**参数说明**: 时间:必需,从中提取小时数的时间
**示例**:
```
HOUR("2026-4-20 10:30:55") => 10
HOUR([打卡时间])
```
---
## MINUTE - 获取分钟
**表达式**: `MINUTE(时间)`
**函数说明**: 获取时间(或转换为数值的时间)的分钟数
**参数说明**: 时间:必需,从中提取分钟数的时间
**示例**:
```
MINUTE("2026-4-20 10:30:55") => 30
MINUTE([会议开始时间])
```
---
## MONTH - 获取月份
**表达式**: `MONTH(日期)`
**函数说明**: 获取日期(或转换为数值的日期)的月份
**参数说明**: 日期:必需,从中提取月份的日期
**示例**:
```
MONTH("2026-4-20") => 4
MONTH([生日])
```
---
## NETWORKDAYS - 工作日天数
**表达式**: `NETWORKDAYS(开始日期,终止日期,[节假日])`
**函数说明**: 返回开始日期和终止日期之间的净工作日天数。工作日不包括周末和专门指定的假期。
**参数说明**:
- 开始日期:必需,一个代表开始日期的日期
- 终止日期:必需,一个代表终止日期的日期
- 节假日:可选,默认为双休日,也可加上列入该参数的日期范围或日期字段
**示例**:
```
NETWORKDAYS("2026/4/18", "2026/4/25", LIST("2026/4/19", "2026/5/18")) => 5
//计算 2026/4/18 和 2026/4/25 之间除去2026/4/19和双休日后的天数
NETWORKDAYS([开始日期], [结束日期])
```
---
## NOW - 当前日期时间
**表达式**: `NOW()`
**函数说明**: 返回当前日期和时间
**参数说明**: NOW 函数语法没有参数
**示例**:
```
NOW()=>返回当前时间
```
---
## SECOND - 获取秒数
**表达式**: `SECOND(时间)`
**函数说明**: 获取时间(或转换为数值的时间)的秒数
**参数说明**: 时间:必需,从中提取秒数的时间
**示例**:
```
SECOND("2026-4-20 10:30:55") => 55
```
---
## TODAY - 当前日期
**表达式**: `TODAY()`
**函数说明**: 返回今天的日期。
**参数说明**: TODAY 函数语法没有参数
**示例**:
```
TODAY() => 返回当前日期
IF([截止日期] < TODAY(), "已超期", "进行中")
```
---
## WEEKDAY - 星期几
**表达式**: `WEEKDAY(日期值, [类型])`
**函数说明**: 返回对应于某个日期的一周中的第几天。 默认情况下,天数是1(星期日)到7(星期六)范围内的整数。
**参数说明**:
- 日期值:必需,要查找的那一天的日期
- 类型:可选。用于确定返回值类型的数字
- 输入1或省略,返回数字1(星期日)到7(星期六)
- 输入2,返回数字 1(星期一)到7(星期日)
- 输入3,返回数字0(星期一)到6(星期六)
- 输入11,返回数字 1(星期一)到7(星期日)
- 输入12,返回数字 1(星期二)到7(星期一)
- 输入13,返回数字1(星期三)到7(星期二)
- 输入14,返回数字 1(星期四)到7(星期三)
- 输入15,返回数字 1(星期五)到7(星期四)
- 输入16,返回数字 1(星期六)到7(星期五)
- 输入17,返回数字1(星期日)到7(星期六)
**示例**:
```
WEEKDAY("2026/4/15", 3) => 2
WEEKDAY([日期])
// 判断是否为周末
IF(OR(WEEKDAY([日期]) = 1, WEEKDAY([日期]) = 7), "周末", "工作日")
```
---
## WEEKNUM - 第几周
**表达式**: `WEEKNUM(日期, [类型])`
**函数说明**: 返回日期在当前年份的第几周
**参数说明**:
- 日期:必需。需要返回所在周序号的目标日期,可以是日期字段或格式为日期类型的数字、公式字段等
- 类型:可选。默认为 1,表示一周的第 1 天从星期几开始
- 1或省略 代表星期天开始
- 2 代表星期一开始
- 11 代表星期一开始
- 12 代表星期二开始
- 13 代表星期三开始
- 14 代表星期四开始
- 15 代表星期五开始
- 16 代表星期六开始
- 17 代表星期日开始
- 21代表星期一开始
**示例**:
```
WEEKNUM("2000-01-01")=> 1
WEEKNUM([日期])
```
---
## WORKDAY - 工作日计算
**表达式**: `WORKDAY(起始日期, 天数, [节假日])`
**函数说明**: 返回起始日期之前或之后指定工作日数的日期。工作日不包含周末以及节假日。
**参数说明**:
- 开始日期:必需,计算的开始日期
- 天数:必需,开始日期之前或之后的非周末和非假日的天数。正值代表未来的日期;负值代表过去的日期。如果天数不是整数,则会截除其小数部分
- 节假日:可选,默认双休日,一个范围或数组常量
**示例**:
```
WORKDAY(DATE(2026,4,15), 4, LIST("2026/4/16", "2026/5/18")) => "2026/4/22"
//在计算工期时会将跳过 2026/5/18 和 2026/4/16 和双休日
WORKDAY(TODAY(), 3) // 3个工作日后的日期
```
---
## YEAR - 获取年份
**表达式**: `YEAR(日期)`
**函数说明**: 获取日期(或转换为数值的日期)的年份
**参数说明**: 日期:必需, 从中提取年份的日期
**示例**:
```
YEAR("2026-4-20") => 2026
YEAR([入职日期])
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |