函數

XYHcms模板中可用函數大全|使用方法

模板中可用函數大全

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

模板中使用函數，只針對模板標簽中字段值。形式如

{標簽字段|函數名=###,參數2,.....,參數n}

{標簽字段|函數名=參數2,.....,參數n}

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

<!--內容頁 獲取標題前20個字符串 -->
{$content.title|str2sub=###,20}

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

YYCMS函數指南

str2sub函數 | 返回指定長度的字符串

str2sub(str, num, flag, sp)

參數說明：
 [1] str 表示要截取的字符串。必需；
 [2] num 表示返回的字符串長度。必需[數字]；
 [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條記錄，標題只顯示20個字符，摘要只顯示100個字符

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

get_picture(str, width, height, rnd)

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

例子：

<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函數 | 用于格式化時間或日期(php自帶)

date(format,timestamp)

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

參數說明：
 [1] format 表示返回的日期格式。必需；
 [2] timestamp 表示要轉換的時間戳。必需；

什么是時間戳（Timestamp）？
時間戳是自 1970 年 1 月 1 日（00:00:00 GMT）以來的秒數。它也被稱為 Unix 時間戳（Unix Timestamp）。

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

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

例子：

<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 這種顯示樣式