📄 vba函数说明.htm
字号:
函数的返回值为负数。</p>
<p class="T"><b><i>firstdayofweek</i></b>
参数会影响使用时间间隔符号 “W” 或 “WW” 计算的结果。</p>
<p class="T">如果 <i>date1 </i>或 <i>date2 </i>是日期文字，则指定的年份成为该日期的固定部分。但是，如果
<i>date1 </i>或 <i>date2 </i>用双引号 (" ")
括起来，且年份略而不提，则在每次计算表达式 <i>date1 </i>或
<i>date2 </i>时，当前年份都会插入到代码之中。这样就可以书写适用于不同年份的程序代码。</p>
<p class="T">在计算 12 月 31 日和来年的 1 月 1 日的年份差时，<b>DateDiff</b>
返回 1 表示相差一个年份，虽然实际上只相差一天而已。</p>
<h1 align="center"><font color="#FFFFFF">DatePart 函数 </font> </h1>
<p class="T">返回一个包含已知日期的指定时间部分的 <b>Variant</b>
(<b>Integer</b>)。</p>
<p><b>语法</b></p>
<p class="SYN"><b>DatePart(<i>interval,</i></b> <b><i>date</i></b>[<b><i>,firstdayofweek</i></b>[<b><i>,</i></b>
<b><i>firstweekofyear</i></b>]]<b>)</b>
<p class="T"><b>DatePart</b> 函数语法中有下列命名参数：</p>
<table cellSpacing="4" cols="2" cellPadding="4">
<tbody>
<tr vAlign="top">
<th width="25%">部分</th>
<th width="75%">描述</th>
</tr>
<tr vAlign="top">
<td class="T" width="25%"><b><i>interval</i></b></td>
<td class="T" width="75%">必要。字符串表达式，是要返回的时间间隔。</td>
</tr>
<tr vAlign="top">
<td class="T" width="25%"><b><i>date</i></b></td>
<td class="T" width="75%">必要。要计算的 <b>Variant </b>(<b>Date</b>)
值。</td>
</tr>
<tr vAlign="top">
<td class="T" width="25%"><b><i>Firstdayofweek</i></b></td>
<td class="T" width="75%">可选。指定一个星期的第一天的常数。如果未予指定，则以星期日为第一天。</td>
</tr>
<tr vAlign="top">
<td class="T" width="25%"><b><i>firstweekofyear</i></b></td>
<td class="T" width="75%">可选。指定一年第一周的常数。如果未予指定，则以包含
1 月 1 日的星期为第一周。</td>
</tr>
</tbody>
</table>
<p><b>设置</b></p>
<p class="T"><b><i>interval </i></b>参数的设定值如下：</p>
<table cellSpacing="4" cols="2" cellPadding="4">
<tbody>
<tr vAlign="top">
<th width="14%">设置</th>
<th width="86%">描述</th>
</tr>
<tr vAlign="top">
<td class="T" width="14%">yyyy</td>
<td class="T" width="86%">年</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">q</td>
<td class="T" width="86%">季</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">m</td>
<td class="T" width="86%">月</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">y</td>
<td class="T" width="86%">一年的日数</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">d</td>
<td class="T" width="86%">日</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">w</td>
<td class="T" width="86%">一周的日数</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">ww</td>
<td class="T" width="86%">周</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">h</td>
<td class="T" width="86%">时</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">n</td>
<td class="T" width="86%">分钟</td>
</tr>
<tr vAlign="top">
<td class="T" width="14%">s</td>
<td class="T" width="86%">秒</td>
</tr>
</tbody>
</table>
<p class="T"><b><i>firstdayofweek </i></b>参数的设定值如下：</p>
<table cellSpacing="4" cols="3" cellPadding="4">
<tbody>
<tr vAlign="top">
<th width="26%">常数</th>
<th width="12%">值</th>
<th width="62%">描述</th>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbUseSystem</b></td>
<td class="T" width="12%">0</td>
<td class="T" width="62%">使用 NLS API 设置。</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbSunday</b></td>
<td class="T" width="12%">1</td>
<td class="T" width="62%">星期日（缺省值）</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbMonday</b></td>
<td class="T" width="12%">2</td>
<td class="T" width="62%">星期一</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbTuesday</b></td>
<td class="T" width="12%">3</td>
<td class="T" width="62%">星期二</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbWednesday</b></td>
<td class="T" width="12%">4</td>
<td class="T" width="62%">星期三</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbThursday</b></td>
<td class="T" width="12%">5</td>
<td class="T" width="62%">星期四</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbFriday</b></td>
<td class="T" width="12%">6</td>
<td class="T" width="62%">星期五</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbSaturday</b></td>
<td class="T" width="12%">7</td>
<td class="T" width="62%">星期六</td>
</tr>
</tbody>
</table>
<p class="T"><b><i>firstweekofyear </i></b>参数的设定值如下：</p>
<table cellSpacing="4" cols="3" cellPadding="4">
<tbody>
<tr vAlign="top">
<th width="26%">常数</th>
<th width="12%">值</th>
<th width="62%">描述</th>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbUseSystem</b></td>
<td class="T" width="12%">0</td>
<td class="T" width="62%">使用 NLS API 设置。</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbFirstJan1</b></td>
<td class="T" width="12%">1</td>
<td class="T" width="62%">从包含 1 月 1
日的星期开始（缺省值）。</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbFirstFourDays</b></td>
<td class="T" width="12%">2</td>
<td class="T" width="62%">从第一个其大半个星期在新的一年的一周开始。</td>
</tr>
<tr vAlign="top">
<td class="T" width="26%"><b>vbFirstFullWeek</b></td>
<td class="T" width="12%">3</td>
<td class="T" width="62%">从第一个无跨年度的星期开始。</td>
</tr>
</tbody>
</table>
<p><b>说明</b></p>
<p class="T"><b>DatePart</b>
函数可以用来计算日期并返回指定的时间间隔。例如，可以使用<b>DatePart
</b>计算某个日期是星期几或目前为几点钟。</p>
<p class="T"><b><i>firstdayofweek</i></b>
参数会影响使用时间间隔符号 “W” 或 “WW” 计算的结果。</p>
<p class="T">如果 <i>date</i> 是日期文字，则指定的年份成为该日期的固定部分。但是，如果
<i>date</i> 用双引号 (" ")
括起来，且年份略而不提，则在每次计算 <i>date</i>
表达式时，当前年份都会插入到代码之中。这样就可以书写适用于不同年份的程序代码。</p>
<h1 align="center"><font color="#FFFFFF">DateSerial 函数 </font> </h1>
<p class="T">返回包含指定的年、月、日的 <b>Variant</b> (<b>Date</b>)。</p>
<p><b>语法</b></p>
<p class="SYN"><b>DateSerial(<i>year</i>, <i>month</i>, <i>day</i>)</b>
<p class="T"><b>DateSerial</b> 函数语法有下列的命名参数：</p>
<table cellSpacing="4" cols="2" cellPadding="4">
<tbody>
<tr vAlign="top">
<th width="12%">部分</th>
<th width="88%">描述</th>
</tr>
<tr vAlign="top">
<td class="T" width="12%"><b><i>year</i></b></td>
<td class="T" width="88%">必要；<b>Integer。</b>从 100 到 9999
间的整数，或一数值表达式。</td>
</tr>
<tr vAlign="top">
<td class="T" width="12%"><b><i>month</i></b></td>
<td class="T" width="88%">必要；<b>Integer。</b>任何数值表达式。</td>
</tr>
<tr vAlign="top">
<td class="T" width="12%"><b><i>day</i></b></td>
<td class="T" width="88%">必要；<b>Integer。</b>任何数值表达式。</td>
</tr>
</tbody>
</table>
<p><b>说明</b></p>
<p class="T">为了指定某个日期，如 1991 年 12 月 31 日，<b>DateSerial</b>
函数中的每个参数的取值范围应该是可接受的；即，日的取值范围应在
1-31 之间，而月的取值范围应在 1-12
之间。但是，当一个数值表达式表示某日之前或其后的年、月、日数时，也可以为每个使用这个数值表达式的参数指定相对日期。</p>
<p class="T">以下示例中使用了数值表达式代替绝对日期。这里，<b>DateSerial
</b>函数返回 1990 年 8 月 1 日的 十 年 (<code>1990 - 10</code>)
零两个月 (<code>8 - 2</code>) 又一天 (<code>1 - 1</code>)
之前的日期；换句话说，就是 1980 年 5 月 31 日。</p>
<pre class="CT"><code>DateSerial(1990 - 10, 8 - 2, 1 - 1)
</code></pre>
<p class="T"><b><i>year</i></b> 参数的数值若介于 0 与 29
之间，则将其解释为 2000–2029年，若介于 30 和 99
之间则解释为1930–1999年。而对所有其它 <b><i>year</i></b>
参数，则请用四位数值表示（如 1800）。</p>
<p class="T">当任何一个参数的取值超出可接受的范围时，它会适时进位到下一个较大的时间单位。例如，如果指定了
35
天，则这个天数被解释成一个月加上多出来的日数，多出来的日数将由其年份与月份来决定。如果一个参数值超出
-32，768 到 32，767 的范围，就会导致错误发生。</p>
<h1 align="center"><font color="#FFFFFF">DateValue 函数</font></h1>
<p class="T">返回一个<b> Variant</b> (<b>Date</b>)。</p>
<p><b>语法</b></p>
<p class="SYN"><b>DateValue(</b><i>date</i><b>)</b>
<p class="T">必要的 <i>date</i> 参数
<i>date </i>通常是字符串表达式，表示从
100 年 1 月 1 日到 9999 年 12 月 31 日之间的一个日期。但是，<i>date
</i>也可以是任何表达式，其所代表的日期、时间在上述范围内。</p>
<p><b>说明</b></p>
<p class="T">如果 <i>date</i>
是一个字符串，且其内容只有数字以及分隔数字的日期分隔符，则
<b>DateValue </b>就会根据系统中指定的短日期格式来识别月、日、年的顺序。<b>DateValue</b>
也识别明确的英文月份名称，全名或缩写均可。例如，除了
12/30/1991 和 12/30/91 之外，<b>DateValue</b> 也识别 December 30, 1991
和 Dec 30, 1991。</p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -