函數(shù)

XYHcms模板中可用函數(shù)大全|使用方法

模板中可用函數(shù)大全

XYHcms模板可以使用的函數(shù)包括兩部分  
 1、php系統(tǒng)中的函數(shù)（只選擇一部分常用的講解，其他略）  
2、XYHcms自帶的函數(shù)

模板中使用函數(shù)，只針對(duì)模板標(biāo)簽中字段值。形式如

{標(biāo)簽字段|函數(shù)名=###,參數(shù)2,.....,參數(shù)n}

{標(biāo)簽字段|函數(shù)名=參數(shù)2,.....,參數(shù)n}

注：字段對(duì)應(yīng)函數(shù)參數(shù)位置處，用###代替即可，如果在第一個(gè)參數(shù)位置，可以省略不寫，其他參數(shù)位置不能省略(上面兩個(gè)格式等同)
 
   例子：

<!--內(nèi)容頁(yè) 獲取標(biāo)題前20個(gè)字符串 -->
{$content.title|str2sub=###,20}

<!--內(nèi)容頁(yè) 將發(fā)布時(shí)間轉(zhuǎn)成 2014年4月1日 的樣式顯示-->
{$content.publishtime|date='Y年m月d日',###}

YYCMS函數(shù)指南

str2sub函數(shù) | 返回指定長(zhǎng)度的字符串

str2sub(str, num, flag, sp)

參數(shù)說(shuō)明：
 [1] str 表示要截取的字符串。必需；
 [2] num 表示返回的字符串長(zhǎng)度。必需[數(shù)字]；
 [3] flag 表示是否顯示省略符。可選[0|1]；
 [4] sp 表示省略符。可選["..."]；

例子：

<yang:list typeid='1' limit='6'>
   <a href="{$list.url}">{$list.title|str2sub=###,20}</a>
   <p>{$list.description|str2sub=100}</p><br/>
</yang:list>

注解：獲取欄目id為1的6條記錄，標(biāo)題只顯示20個(gè)字符，摘要只顯示100個(gè)字符

get_picture函數(shù) | 返回指定尺寸大小的圖片地址(需要后臺(tái)縮略圖支持)

get_picture(str, width, height, rnd)

參數(shù)說(shuō)明：
 [1] str 表示要截取的字符串。必需[圖片地址]；
 [2] width 表示返回的圖片寬度。為0時(shí)，返回原始圖片地址。可選[數(shù)字]；
 [3] height 表示返回的圖片高。可選[數(shù)字]；
 [4] rnd 表示隨機(jī)數(shù)。可選；

例子：

<yang:list typeid='1' limit='6'>
   <a href="{$list.url}">{$list.title}</a>
   <img src="{$list.litpic|get_picture=60,60}" /><br/>
</yang:list>

注解：獲取欄目id為1的6條記錄，縮略圖尺寸為60X60

date函數(shù) | 用于格式化時(shí)間或日期(php自帶)

date(format,timestamp)

注：由于獲取的日期時(shí)間字段，一般都是時(shí)間戳形式，必須轉(zhuǎn)換后，才能顯示為我們看得懂的正常的日期

參數(shù)說(shuō)明：
 [1] format 表示返回的日期格式。必需；
 [2] timestamp 表示要轉(zhuǎn)換的時(shí)間戳。必需；

什么是時(shí)間戳（Timestamp）？
時(shí)間戳是自 1970 年 1 月 1 日（00:00:00 GMT）以來(lái)的秒數(shù)。它也被稱為 Unix 時(shí)間戳（Unix Timestamp）。

格式化日期
date() 函數(shù)的第一個(gè)參數(shù)規(guī)定了如何格式化日期/時(shí)間。它使用字母來(lái)表示日期和時(shí)間的格式。這里列出了一些可用的字母：
d - 月中的天 (01-31)
m - 當(dāng)前月，以數(shù)字計(jì) (01-12)
Y - 當(dāng)前的年（四位數(shù)）
H - 小時(shí)（00 到 23）
i - 分鐘數(shù)（00 到 59）
s - 秒數(shù)（00 到 59）

您可以在PHP  參考手冊(cè)中，找到格式參數(shù)中可以使用的所有字母。

例子：

<yang:list typeid='1' limit='6'>
   <li><a href="{$list.url}">{$list.title} {$list.publishtime|date='Y-m-d H:i:s',###}</a></li>
</yang:list>

注解：獲取欄目id為1的6條記錄，發(fā)布日期格式為 2014-04-01 10:22:50 這種顯示樣式