TwitchDownloader文件名模板时间格式使用指南

在TwitchDownloader工具中，用户经常需要自定义记录或视频下载的文件名格式。本文重点讲解时间格式字符串的正确使用方法，帮助用户避免常见错误。

时间格式字符串基础

TwitchDownloader支持通过模板变量来自定义文件名，其中涉及时间格式的主要有：

• {date_custom="格式字符串"}：文件创建日期
• {trim_start_custom="格式字符串"}：视频剪辑开始时间
• {trim_end_custom="格式字符串"}：视频剪辑结束时间

常见错误解析

用户在使用过程中容易犯以下错误：

1. 大小写错误：使用H表示小时（24小时制）是不被支持的，应该使用小写h。

2. 特殊字符未转义：在格式字符串中，连字符-是特殊字符，需要转义为\-才能正常显示。

3. 格式字符串不完整：缺少必要的格式说明符会导致解析失败。

正确格式示例

对于想要显示"小时-分钟-秒"格式的用户，应该使用：

{trim_start_custom="hh\-mm\-ss"}

或者更简单的方案是直接使用预定义格式：

{trim_start}

这会自动采用"HH-mm-ss"的格式输出。

最佳实践建议

1. 对于简单的时间格式需求，优先使用预定义的变量如{trim_start}，避免自定义格式的复杂性。

2. 当确实需要自定义格式时：

   • 使用小写字母表示时间单位
   • 对特殊字符进行转义
   • 先在简单案例上测试

3. 考虑在文件名模板中使用统一的时间格式，保持一致性。

通过理解这些时间格式的使用规则，用户可以更灵活地定制TwitchDownloader生成的文件名，同时避免常见的格式错误。