# date 日期格式化標簽 ## 日期格式化標簽 格式化日期時間 ## 格式 $Info\['publish\_time'\] 文章發布時間 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>date name<span class="token">=</span><span class="token4">"$Info['publish_time']"</span> format<span class="token">=</span><span class="token4">"Y-m-d H:i:s"</span><span class="token1">}</span> ``` ``` ## 參數 參數名稱可選值默認值是否必填支持版本說明name--是-待轉換的值，傳入變量或指定日期format-Y-m-d--格式api--->=v2.2.1.20220603詳情看下面lt--->=v2.2.1.20220603小于多少秒format 日期與時間格式參數說明 - d - 表示月里的某天（01-31） - m - 表示月（01-12） - Y - 表示年（四位數） - l - 表示周里的某天 - h - 帶有首位零的 12 小時小時格式 - H - 24小時格式 - i - 帶有首位零的分鐘 - s - 帶有首位零的秒（00 -59） - a - 小寫的午前和午后（am 或 pm） ## 示例 - 內容標簽里面對內容發布日期格式化 ``` <pre class="calibre16">``` <span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"10"</span> order<span class="token">=</span><span class="token4">"weigh desc,views desc"</span> num<span class="token">=</span><span class="token4">"$Cate['num']"</span><span class="token1">}</span> <span class="token"><</span>span class<span class="token">=</span><span class="token4">"date"</span><span class="token">></span><span class="token1">{</span>hkcms<span class="token1">:</span>date name<span class="token">=</span><span class="token4">"$item.publish_time"</span> format<span class="token">=</span><span class="token4">"Y-m-d"</span><span class="token1">}</span><span class="token"><</span><span class="token">/</span>span<span class="token">></span> <span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span> ``` ``` - 語義化日期，例如：**3小時前，1個月前，56秒前**，剛剛。（ >=v2.2.1.20220603） `api="human"` 將采用日期語義化顯示 ``` <pre class="calibre16">``` <span class="token5">//，lt="2592000" 單位秒， 表示超過一個月的按format里面的格式輸出，如果不需要那直接只寫api="human"即可</span> <span class="token"><</span>span class<span class="token">=</span><span class="token4">"date"</span><span class="token">></span><span class="token1">{</span>hkcms<span class="token1">:</span>date name<span class="token">=</span><span class="token4">"$item.publish_time"</span> format<span class="token">=</span><span class="token4">"Y-m-d"</span> api<span class="token">=</span><span class="token4">"human"</span> lt<span class="token">=</span><span class="token4">"2592000"</span><span class="token1">}</span><span class="token"><</span><span class="token">/</span>span<span class="token">></span> ``` ``` 全部語義化 ``` <pre class="calibre16">``` <span class="token"><</span>span class<span class="token">=</span><span class="token4">"date"</span><span class="token">></span><span class="token1">{</span>hkcms<span class="token1">:</span>date name<span class="token">=</span><span class="token4">"$item.publish_time"</span> api<span class="token">=</span><span class="token4">"human"</span><span class="token1">}</span><span class="token"><</span><span class="token">/</span>span<span class="token">></span> ``` ``` - 時間戳(1601528401)轉化成格式2020-10-01 13:00:01 ``` <pre class="calibre16">``` <span class="token5">// name 可以傳入變量</span> <span class="token1">{</span>hkcms<span class="token1">:</span>date name<span class="token">=</span><span class="token4">"$item.create_time"</span> format<span class="token">=</span><span class="token4">"Y-m-d H:i:s"</span><span class="token1">}</span> ``` ``` - 將日期2020-10-01 13:00:01，轉換成2020年10月01日 ``` <pre class="calibre20">``` <span class="token"><</span><span class="token">?</span>php $d <span class="token">=</span> <span class="token4">'2020-10-01 13:00:01'</span><span class="token1">;</span><span class="token">?</span><span class="token">></span> <span class="token5">// 傳入變量</span> <span class="token1">{</span>hkcms<span class="token1">:</span>date name<span class="token">=</span><span class="token4">"$d"</span> format<span class="token">=</span><span class="token4">"Y年m月d日"</span><span class="token1">}</span> ``` ```