Adobe 插件：formatTime

formatTime 插件允许您获取任意秒数，并在四舍五入到所需的基准值后以存储段格式提供它们。如果您希望以秒为单位捕获时间值并将其转换为存储段格式（如分钟、天或周），Adobe 建议使用此插件。如果您不想将基于秒的值存储为时间舍入格式，则不需要使用此插件。

使用 Adobe Experience Platform Launch 扩展安装此插件

Adobe 提供了一个扩展，通过该扩展，您可以使用一些最常用的插件。

1. 使用您的 Adobe ID 凭据登录 launch.adobe.com。
2. 单击所需的属性。
3. 转到扩展选项卡，然后单击目录按钮
4. 安装并发布常用 Analytics 插件扩展
5. 如果还没有任何扩展，请使用以下配置创建一个标签为“初始化插件”的规则：
   • 条件：无
   • 事件：核心 - 已加载的库（页面顶部）
6. 使用以下配置向上述规则添加操作：
   • 扩展：常用 Analytics 插件
   • 操作类型：初始化 formatTime
7. 保存并发布对上述规则所做的更改。

使用 Launch 自定义代码编辑器安装此插件

如果您不想使用插件扩展，则可以使用自定义代码编辑器。

1. 使用您的 Adobe ID 凭据登录 launch.adobe.com。
2. 单击所需的属性。
3. 转到扩展选项卡，然后单击 Adobe Analytics 扩展下的配置按钮。
4. 展开使用自定义代码配置跟踪折叠面板，这会显示打开编辑器按钮。
5. 打开自定义代码编辑器，并将下面提供的插件代码粘贴到编辑窗口中。
6. 保存并发布对此 Analytics 扩展所做的更改。

使用 AppMeasurement 安装此插件

在实例化（使用 s_gi）Analytics 跟踪对象后，将以下代码复制并粘贴到 AppMeasurement 文件中的任意位置。在您的实施中保留代码的注释和版本号可帮助 Adobe 对任何潜在问题进行疑难解答。

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: formatTime v1.1 (Requires inList plug-in) */
s.formatTime=function(ns,tf,bml){var s=this;if(!("undefined"===typeof ns||isNaN(ns)||0>Number(ns))){if("string"===typeof tf&&"d"===tf||("string"!==typeof tf||!s.inList("h,m,s",tf))&&86400<=ns){tf=86400;var d="days";bml=isNaN(bml)?1:tf/(bml*tf)} else"string"===typeof tf&&"h"===tf||("string"!==typeof tf||!s.inList("m,s",tf))&&3600<=ns?(tf=3600,d="hours", bml=isNaN(bml)?4: tf/(bml*tf)):"string"===typeof tf&&"m"===tf||("string"!==typeof tf||!s.inList("s",tf))&&60<=ns?(tf=60,d="minutes",bml=isNaN(bml)?2: tf/(bml*tf)):(tf=1,d="seconds",bml=isNaN(bml)?.2:tf/bml);ns=Math.round(ns*bml/tf)/bml+" "+d;0===ns.indexOf("1 ")&&(ns=ns.substring(0, ns.length-1));return ns}};

/* Adobe Consulting Plugin: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

使用此插件

formatTime 方法使用以下参数：

• ns（必需，整数）：要转换或格式化的秒数
• tf（可选，字符串）：要返回秒的格式类型；默认为秒
  • 如果您希望以天为单位显示时间，则可将其设置为 "d"（默认情况下，舍入到以 1/4 天为基准所得出的最近值）
  • 如果您希望以小时为单位显示时间，则可将其设置为 "h"（默认情况下，舍入到以 1/4 小时为基准所得出的最近值）
  • 如果您希望以分钟为单位显示时间，则可将其设置为 "m"（默认情况下，舍入到以 1/2 分钟为基准所得出的最近值）
  • 如果您希望以秒为单位显示时间，则可将其设置为 "s"（默认情况下，舍入到以 5 秒为基准所得出的最近值）
• bml（可选，数字）：舍入基准的长度。默认为 tf 参数中列出的基准值

该方法会返回使用 tf 参数中指定的单位进行格式化的秒数。如果未设置 tf 参数：

• 若返回值小于 1 分钟，则将以“5 秒”为基准四舍五入到最接近的值
• 若返回值介于 1 分钟和 1 小时之间，则将以“0.5 分钟”为基准四舍五入到最接近的值
• 若返回值介于 1 小时和 1 天之间，则将以“0.25 小时”为基准四舍五入到最接近的值
• 若返回值大于 1 天，则将以“1 天”为基准四舍五入到最接近的值

示例

示例 1

以下代码…

s.eVar1 = s.formatTime(38242);

…将 s.eVar1 设置为等于“10.5 小时”

传入的参数（38242 秒）等于 10 小时 37 分钟 22 秒。由于此调用中未设置 tf 参数，且传入的秒数介于 1 小时和 1 天之间，因此插件将返回已转换为以四分之一小时为基准所得出的最近值的秒数。

示例 2

以下代码…

s.eVar1 = s.formatTime(38250);

…将 s.eVar1 设置为等于“10.75 小时”传入的参数（38250 秒）等于 10 小时 37 分钟 30 秒。在这种情况下，如果将传入的秒数舍入到以四分之一小时为基准所得出的最近值，则会将最终值设置为 10.75 小时

示例 3

以下代码…

s.eVar1 = s.formatTime(38242, "m");

…将 s.eVar1 设置为等于“637.5 分钟”

在这种情况下，“m”参数会强制插件将秒数转换为以 1/2 分钟为基准所得出的最近值

示例 4

以下代码…

s.eVar1 = s.formatTime(38242, "m", 20);

…将 s.eVar1 设置为等于“640 分钟”

tf 参数值（“m”）会强制插件将秒数转换为分钟数，但 bml 参数值 (20) 也会强制插件将分钟数转换为以 20 分钟为基准所得出的最近值。

示例 5

以下代码…

s.eVar1 = s.formatTime(125, "s", 2);

…将 s.eVar1 设置为等于“126 秒”，这是以 2 秒为基准时所得出的最接近 125 秒的结果

示例 6

以下代码…

s.eVar1 = s.formatTime(125, "m", 3);

…将 s.eVar1 设置为等于“3 分钟”，这是以 3 分钟为基准时所得出的最接近 125 秒的结果

示例 7

以下代码…

s.eVar1 = s.formatTime(145, "m", .4);

…将 s.eVar1 设置为等于“2.4 分钟”，这是以 2/5 分钟为基准（例如，.4 = 2/5）时所得出的最接近 145 秒的结果

版本历史记录

1.1（2018 年 5 月 21 日）

• 添加了 bml 参数，以便在舍入方面更灵活

1.0（2018 年 4 月 15 日）

• 第一版。