ms:format-date 函式
將標準 XSD 日期格式轉換為輸出所適用的字元。
string ms:format-date(string datetime, string format [,locale])
參數
string datetime
包含 XSD 格式的日期相關值。 對於非字串引數,此函式的行為會和套用 string() 函式時相同。 如果引數不是日期,則會輸出空字串。 若是有效的 XSD 日期且部分欄位是空的,則這個函式會嘗試填入未指定的欄位。string format
根據 Win32 API GetDateFormat 函式,包含格式字串。locale [optional]
定義用來格式化資料的地區設定 (例如 "EN_us")。
備註
底下列出 ms:format-date() 的字元格式。
字元 |
描述 |
---|---|
M |
1-12 的月份 |
MM |
01-12 的月份 |
MMM |
Jan-Dec 的月份 |
MMMM |
January-December 的月份 |
d |
1-31 的日 |
dd |
01-31 的日 |
ddd |
Sun-Sat 的日 |
dddd |
Sunday-Saturday 的日 |
y |
0-99 的年份 |
yy |
00-99 的年份 |
yyyy |
1900-9999 的年份 |
gg |
句點/era (若無則忽略) |
請注意,這個格式不可用於指定時區;不可在格式化的字串中包含任意文字;不可用於世紀;不可使用諸如 May 2nd 或 April1st 等尾碼。
範例
XML 文件 (Sample.xml)
<?xml version='1.0'?>
<XMLSamples xml:space="preserve"
xmlns:dt="urn:schemas-microsoft-com:datatypes">
<FileDetails>
<Author>Robert Brown</Author>
<Date dt:dt="datetime">2000-02-16T15:56:00</Date>
</FileDetails>
</XMLSamples>
XSLT 樣式表 (Sample.xsl)
<?xml version='1.0'?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:ms="urn:schemas-microsoft-com:xslt"
xmlns:dt="urn:schemas-microsoft-com:datatypes">
<xsl:template match="/">
<HTML>
<HEAD>
</HEAD>
<BODY>
<xsl:for-each select="XMLSamples/FileDetails/Date">
<DIV>
Date Unedited:
<xsl:value-of select="."/>
</DIV>
<DIV>
Date Edited:
<xsl:value-of select="ms:format-date(., 'MMM dd, yyyy')"/>
</DIV>
</xsl:for-each>
</BODY>
</HTML>
</xsl:template>
</xsl:stylesheet>
輸出
輸出 HTML 頁面會顯示下列實體:
Date Unedited: 2000-02-16T15:56:00
Date Edited: Feb 16, 2000