FmtStr

對數值運算式或日期/時間運算式進行格式化。

格式
FmtStr 用於指定格式的運算式, 用於指定格式的字串, 輸出字串變數

參數

格式指定運算式: 指定格式指定數值運算式，或日期/時間運算式。
請以「yyyy/mm/dd hh:nn:ss」形式指定日期/時間運算式。
格式指定字串: 指定格式指定字串。
輸出字串變數: 指定輸出字串變數。

說明
依據格式設定字串傳回設定格式的字串。

數值格式指定子

None: 在未格式化的狀態之下直接顯示編號。
(0): 是表示位數位置的位數指標。顯示數值或零。將數值運算式所含之十進位顯示於格式指定字串的「0」位置。在除此以外的情況下，在該位置上顯示「0」。數值位數少於格式指定字串(小數點之前或之後的)「0」的個數時，開頭乃至之後則顯示數個「0」。若數值的小數點右側位數多於格式指定字串小數點右側的「0」的個數，則配合「0」的個數，對數值位數進行四捨五入處理。此外，數值的小數點左側位數多於格式指定字串小數點左側的「0」的個數時，則按原樣直接顯示其餘的位數。
(#): 是表示位數位置的位數指標。用於顯示數值或不顯示任何內容。在格式指定字串的「#」位置上顯示數值運算式的十進位，除此以外情況下，該位置不顯示任何內容。此字元(#)雖具有0位數指標這樣的作用，但數值位數同於或少於格式指定字串小數點左右的「#」的個數時，開頭乃至之後則不顯示「0」。
(.): 用於顯示小數點位置，並設定小數點左右顯示的位數。也有可能依本地設定而用逗號標示小數點。在格式指定字串中，此 (.) 的左側只有數字時，則在開頭處開始和顯示小於數字1的小數點。若要顯示開頭的零，則在小數點左側使用「0」。對於以格式指定輸出的值來表示小數點的字元，則依據使用的Windows所識別的數值格式。
(,): 是用1000分隔數值的千位分隔符號。依本地設定使用句號。對小數點左側有4位數以上的數值，使用每隔一千的分隔方法。標準用法為，格式指定字串包括在左右帶有位數指標(0或#)的千位分隔符號(,)時，指定格式。無論有無指定小數，緊鄰小數點的左側若排列2個千位分隔符號或單獨使用，則表示指定「該數值除以1000，並在必要時進行四捨五入處理」這樣的格式。例如，格式指定字串「##0,,」表示以「100」顯示為1億。小於百萬的數值則顯示為「0」。在緊鄰小數點左側以外的位置上，若並排放置2個千位分隔符號，則只用於分隔千位。在格式指定的輸出值中實際用作千位分隔符號的字元依據使用的Windows所識別的數值格式。

日期/時間格式指定子

(:): 是時間分隔符號。可能依本地設定而使用其它字元。若以格式指定時間值，時間分隔符號則用於對小時、分鐘、秒的值進行分隔。對於以格式指定輸出而實際使用的字元，會依Windows的設定而定。
(/): 是日期分隔符號。可能依本地設定而使用其它字元。若以格式指定日期值，日期分隔符號則用於對日、月、年的值進行分隔。對於以格式指定輸出而實際使用的字元，會依Windows的設定而定。

c: 以ddddd顯示日期，以ttttt顯示時間，依此順序顯示。日期序號上若無分數部分，則只顯示日期；時間訊息上若無整數部分，則只顯示時間訊息。
d: 以開頭不附加零的方式顯示日期。(1～31)
dd: 以開頭附加零的方式顯示日期。(01～31)
ddd: 省略星期顯示。(Sun～Sat)
dddd: 不省略星期顯示。(Sunday～Saturday)
ddddd: 依照Windows的Short資料顯示設定的格式，顯示所有日期、月、年。Windows的Short資料格式預設為m/d/yy。
dddddd: 將日期的序列數值作為日期、月、年，並依Windows的Long資料顯示設定格式進行顯示。Windows的Long資料格式預設為mmmm dd, yyyy。
w: 以數值顯示星期。(1：星期日~7：星期六)

ww: 以數值顯示1年當中的第幾週。(1～54)
m: 以開頭不附加零的數值顯示月份。(1～12)
即便在「h」或「hh」之後使用，也不顯示時間的分鐘。若要顯示時間的分鐘，請使用「n」或「nn」。
mm: 以開頭附加零的數值顯示月份。(01～12)
即便在「h」或「hh」之後使用，也不顯示時間的分鐘。若要顯示時間的分鐘，請使用「n」或「nn」。
mmm: 省略月份名稱顯示。(Jan～Dec)
mmmm: 不省略月份名稱顯示。(January～December)

q: 以數值顯示季度。(1～4)
y: 以數值顯示1年當中的第幾日。(1～366)
yy: 以2位數顯示年號。(00～99)
yyyy: 以4位數顯示年號。(100～9999)
h: 以開頭不附加零的方式顯示24小時制的時間。(0～23)
hh: 以開頭附加零的方式顯示24小時制的時間。(00～23)
n: 以開頭不附加零的方式顯示時間的分鐘。(0～59)
nn: 以開頭附加零的方式顯示時間的分鐘。(00～59)

s: 以開頭不附加零的方式顯示時間的秒鐘。(0～59)
ss: 以開頭附加零的方式顯示時間的秒鐘。(00～59)
t t t t t: 依照Windows設定的時間分隔符號格式，顯示時間(小時、分鐘、秒鐘)。"若選擇「開頭的零」選項，則以開頭附加零的時間制顯示10:00am/pm之前的時間。Windows的預設時間格式為h:nn:ss。

AM/PM: 以12小時制顯示時間，並以AM/PM(以大寫標記)顯示上午/下午。
am/pm: 以12小時制顯示時間，並以am/pm(以小寫標記)顯示上午/下午。
A/P: 以12小時制顯示時間，並以A/P(以大寫標記)顯示上午/下午。
a/p: 以12小時制顯示時間，並以a/p(以小寫標記)顯示上午/下午。

AMPM: 以12小時制顯示時間。依照Windows內的格式設定，上午時間以AM字串顯示，下午時間以PM字串顯示。AM/PM雖不拘大小寫，但Windows的設定和指定字串務必一致。Windows的預設為AM/PM。

注意

混合數值格式指定子和日期/時間格式指定子

若混合指定數值格式指定子和日期/時間格式指定子，會發生錯誤。

參照
Left$、Right$、Str$

FmtStr範例

Function SaveData

    String d$, f$, t$

    ' 以月、日、小時、分鐘的形式建立檔名
    d$ = Date$
    t$ = Time$
    d$ = d$ + " " + t$
    FmtStr d$, "mmddhhnn", f$
    f$ = f$ + ".dat"
    WOpen f$ as #30
    Print #30, "data"
    Close #30
Fend

← Flush FmtStr$函數 →