vba函数说明.htm

VBA帮助手册,VBA函数说明 ,VBA For Word 2000.CHM

    <tr vAlign="top">
      <td class="T" width="15%">yyyy</td>
      <td class="T" width="85%">年</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">q</td>
      <td class="T" width="85%">季</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">m</td>
      <td class="T" width="85%">月</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">y</td>
      <td class="T" width="85%">一年的日数</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">d</td>
      <td class="T" width="85%">日</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">w</td>
      <td class="T" width="85%">一周的日数</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">ww</td>
      <td class="T" width="85%">周</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">h</td>
      <td class="T" width="85%">时</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">n</td>
      <td class="T" width="85%">分钟</td>
    </tr>
    <tr vAlign="top">
      <td class="T" width="15%">s</td>
      <td class="T" width="85%">秒</td>
    </tr>
  </tbody>
</table>
<p><b>说明</b></p>
<p class="T">可以使用 <b>DateAdd </b>函数对日期加上或减去指定的时间间隔。例如，可以用    
<b>DateAdd</b> 
来计算距今天为三十天的日期；或者计算距现在为 45    
分钟的时间。</p>
<p class="T">为了对 <b><i>date </i></b>加上“日”，可以使用“一年的日数”    
(“y”)，“日” (”d”) 或“一周的日数” (”w”)。</p>   
<p class="T"><b>DateAdd </b>函数将不返回有效日期。在以下实例中将    
1 月31 日加上一个月：</p>   
<pre class="CT"><code>DateAdd(m, 1, 31-Jan-95)
</code></pre>
<p class="T">上例中，<b>DateAdd </b>返回 1995 年 2 月 28 日，而不是    
1995 年 2 月 31 日。如果 <b><i>date</i></b> 是 1996 年 1 月 31    
日，则由于 1996 年是闰年，返回值是 1996 年 2 月 29 日。</p>   
<p class="T">如果计算的日期超前 100 年（减去的年度超过 <b><i>date</i></b>    
中的年份），就会导致错误发生。</p>   
<p class="T">如果 <b><i>number</i></b> 不是一个 Long    
值，则在计算时取最接近的整数值来计算。</p> 
<p class="NT"><b>注意</b>&nbsp;&nbsp;&nbsp;<b>DateAdd</b> 
返回值的格式由 <b>Control Panel</b>设置决定，而不是由传递到<b><i>date</i></b>    
参数的格式决定。</p>   
<h1 align="center"><font color="#FFFFFF">DateDiff 函数&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font>&nbsp;</h1>   
<p class="T">返回<b> Variant</b> (<b>Long</b>)    
的值，表示两个指定日期间的时间间隔数目。</p>
<p><b>语法</b></p>
<p class="SYN"><b>DateDiff(<i>interval, date1, date2</i></b>[<b><i>, 
firstdayofweek</i></b>[<b>,</b> <b><i>firstweekofyear</i></b>]]<b>)</b>   
<p class="T"><b>DateDiff</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%">必要。字符串表达式，表示用来计算<b><i>date1</i></b> 
        和 <b><i>date2 </i></b>的时间差的时间间隔</td>   
    </tr>
    <tr vAlign="top">
      <td class="T" width="25%"><b><i>Date1□date2</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>
<br>
<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">　</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>DateDiff</b> 
函数可用来决定两个日期之间所指定的时间间隔数目。例如，可以使用    
<b>DateDiff</b> 
来计算两个日期之间相隔几日，或计算从今天起到年底还有多少个星期。</p>   
<p class="T">为了计算 <b><i>date1</i></b> 与 <b><i>date2 </i></b>相差的日数，可以使用“一年的日数”(y)    
或“日”(d)。当 <b><i>interval</i></b> 是“一周的日数”(w) 时，<b>DateDiff</b>    
返回两日期间的周数。如果 <b><i>date1</i></b> 是星期一，<b>DateDiff</b>    
计算到 <b><i>date2</i></b> 为止的星期一的个数。这个数包含 <b><i>date2</i></b>    
但不包含 <b><i>date1</i></b>。不过，如果 <b><i>interval</i></b> 是“周”(ww)，则    
<b>DateDiff</b> 函数返回两日期间的“日历周”数。由计算 <b><i>date1</i></b>    
与 <b><i>date2 </i></b>之间星期日的个数而得。如果 <b><i>date2 </i></b>刚好是星期日，则    
<b><i>date2</i></b> 也会被加进 <b>DateDiff </b>的计数结果中；但不论    
<b><i>date1 </i></b>是否为星期日，都不将它算进去。</p>
<p class="T">如果 <b><i>date1 </i></b>比 <b><i>date2 </i></b>来得晚，则 <b>DateDiff</b>