如何通过DocuSign REST API为不同签署者设置自定义日期格式及时区

1. 签署流程中按签署者时区与日期格式展示日期 #

当签署者在DocuSign界面选择日期时，默认情况下平台会根据签署者的浏览器区域设置自动适配日期格式（比如美式MM/DD/YYYY或欧式DD/MM/YYYY），同时日期会转换为签署者的本地时区显示。如果需要脱离浏览器设置、强制使用特定格式，就需要通过API在创建信封时为每个签署者单独配置（具体方法见下一个问题）。

另外，若你希望确保日期字段始终以签署者的本地时区呈现，在设置日期类标签时，可以指定该字段使用签署者时区而非发送者时区——这一配置可通过API的timeZone属性或后台模板设置实现。

2. 通过REST API为不同签署者设置自定义日期格式与时区 #

完全可以！使用DocuSign REST API创建信封时，你可以为单个信封内的不同签署者分别指定日期字段的格式和时区，哪怕使用的是dateSignedTab类型的字段。

核心配置要点： #

• 针对每个签署者的dateSignedTab（或其他日期类标签），设置dateFormat属性来指定格式，支持的样式包括MMM-DD-YYYY hh:mm、DD/MM/YYYY、YYYY-MM-DD等多种格式。
• 若要指定时区，可在dateSignedTab中设置timeZone属性（比如Asia/Shanghai、America/New_York），或者通过签署者对象的signerTimeZone属性让该签署者的所有字段默认使用指定时区。

示例代码片段（JSON）： #

假设我们有两个签署者，分别需要不同的日期格式与时区：

{
  "recipients": {
    "signers": [
      {
        "email": "signer1@example.com",
        "name": "张三",
        "recipientId": "1",
        "tabs": {
          "dateSignedTabs": [
            {
              "documentId": "1",
              "pageNumber": "1",
              "xPosition": "100",
              "yPosition": "100",
              "dateFormat": "MMM-DD-YYYY hh:mm",
              "timeZone": "Asia/Shanghai"
            }
          ]
        }
      },
      {
        "email": "signer2@example.com",
        "name": "李四",
        "recipientId": "2",
        "tabs": {
          "dateSignedTabs": [
            {
              "documentId": "1",
              "pageNumber": "1",
              "xPosition": "200",
              "yPosition": "100",
              "dateFormat": "DD-MM-YYYY HH:mm",
              "timeZone": "America/Los_Angeles"
            }
          ]
        }
      }
    ]
  },
  "status": "sent"
}

注意事项： #

• 确保使用DocuSign官方支持的格式字符串，避免出现格式不生效的情况。
• 如果未明确设置timeZone，系统会默认使用签署者的浏览器时区；若设置了signerTimeZone，该签署者的所有未单独指定时区的字段都会继承这个设置。

内容的提问来源于stack exchange，提问作者Suhas