Format
 
格式化指定格式的数字

语法

Declare Function Format ( ByVal numerical_expression As Double, ByRef formatting_expression As Const String = "" ) As String

用法

#include "string.bi"
result = Format[$]( numerical_expression , formatting_expression )

参数

numerical_expression
数字格式
formatting_expression
格式模式模式

返回值

Format返回一个字符串，其格式为格式化表达式中的数值表达式。
格式化表达式是可以产生数字或日期时间值的字符串。

说明

为了恢复有意义的日期时间值，数字表达式必须是从适当的函数获取的日期序列。
此函数是FreeBASIC的一部分，但除非包含vbcompat.bi，否则编译器无法识别该函数。

“数字格式”
符号描述
空字符串一般格式（无格式）
0数字占位符：如果数字的数字少于格式表达式中的零（在十进制的两边），则显示前导或尾部零。如果格式中的十进制数右边的数字比零的数字更多，则数字将舍入。如果十进制左边的数字比数字更多，格式为零，数字全部显示
#数字占位符：遵循与0数字相同的规则，但不显示前导或尾部零
.小数点的占位符。如果格式只包含左侧的＃。那么小于1的数字将以小数点开始。
%百分比：表达式乘以100，并插入％字符。
,数千个分隔符两个相邻的逗号或位于小数点位置左侧的逗号（无论是否指定小数位）表示“省略逗号和逗号之间的三位数”，请根据需要舍入“。
E- E+ e- e+科学格式：如果格式在E，E +，e-或e +的右侧包含一位数字占位符（0或＃），则以科学格式显示该数字，并将E或e插入到数字和指数。右边的0或＃的数字决定了指数中的位数。使用E-或e-在负指数旁边放置一个减号。使用E +或e +在负指数旁边放置一个减号，在正指数旁边加上一个加号。
: ? + $ () 空格显示文字字符要显示除这些之外的其他字符，请在字符前加反斜杠（\\），或将字符括在双引号中
\显示格式字符串中的下一个字符
双引号之间的文字显示双引号内的文本。
:时间分隔符用于分隔格式化时间值的时间，分钟和秒。
/日期分隔符用于分隔日期值格式化的日期，月份和年份。


“日期时间格式：”
符号描述
d, dd以1位/ 2位数字显示日期（1-31 / 01-31）
ddd显示日期为缩写（Sun-Sat）
dddd以全名显示日期（星期日 - 星期六）
ddddd显示序列号作为完整日期（包括日，月，年）
m,mm以1位/ 2位数字显示月份（1-12 / 01-12）。如果在h或h之后立即显示分钟而不是月份
M, MM显示月份为一位/两位数字（1-12 / 01-12），即使紧随h或hh
mmm显示月份为缩写（Jan-Dec）
mmm显示月份为全名（1月至12月）
y,yy将年份显示为两位数字（00-99）
yyyy显示年份为四位数字（1900-2040）
h,hh将小时显示为一位/两位数字（0-23 / 00-23）
m,mm将分钟显示为一位/两位数字（0-59 / 00-59）。如果不是紧随h或hh，则显示月份而不是分钟
n,nn将分钟显示为一位/两位数字（0-59 / 00-59），即使不是在h或hh后立即
s,ss显示第二个为一位/两位数字（0-59 / 00-59）
ttttt将时间序列号显示为一个完整的时间，包括小时，分钟和秒
AM / PM（默认），am / pm使用12小时制的时钟，在中午之前的任何一个小时，PM或pm，中午和11:59之间的任何一个小时
A / P，a / p使用12小时制的时钟，在中午之前的任何一小时，P或p显示A或A，中午和11:59之间的任何时间



例子

Sample numeric formats
Format (fmt)                  5             -5            .5
     
     Null String                   5             -5            0.5
     0                             5             -5            1
     0.00                          5.00          -5.00         0.50
     #,##0                         5             -5            1
     #,##0.00                      5.00          -5.00         0.50
     0%                            500%          -500%         50%
     0.00%                         500.00%       -500.00%      50.00%
     0.00E+00                      5.00E+00      -5.00E+00     5.00E-01
     0.00E-00                      5.00E00       -5.00E00      5.00E-01
 Sample Date And Time Formats
The following are examples of Date And Time formats:
      Format  Expression     Display
      m/d/yy                 12/7/58
      d-mmmm-yy              7-December-58
      d-mmmm                 7-December
      mmmm-yy                December-58
      h:mm AM/PM             8:50 PM
      h:mm:ss AM/PM          8:50:35 PM
      h:mm                   20:50
      h:mm:ss                20:50:35
      m/d/yy h:mm            12/7/58 20:50

方言差异

没有

与QB差别

  • QB 4.5中不存在。该函数首先出现在PDS 7.1中

参考