1<?xml version="1.0" encoding="UTF-8"?>
2<helpdocument version="1.0">
3
4<!--
5***********************************************************************
6 *
7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 *
9 * Copyright 2000, 2010 Oracle and/or its affiliates.
10 *
11 * OpenOffice.org - a multi-platform office productivity suite
12 *
13 * This file is part of OpenOffice.org.
14 *
15 * OpenOffice.org is free software: you can redistribute it and/or modify
16 * it under the terms of the GNU Lesser General Public License version 3
17 * only, as published by the Free Software Foundation.
18 *
19 * OpenOffice.org is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22 * GNU Lesser General Public License version 3 for more details
23 * (a copy is included in the LICENSE file that accompanied this code).
24 *
25 * You should have received a copy of the GNU Lesser General Public License
26 * version 3 along with OpenOffice.org.  If not, see
27 * <http://www.openoffice.org/license.html>
28 * for a copy of the LGPLv3 License.
29 *
30 ************************************************************************
31 -->
32
33
34<meta>
35      <topic id="textsbasicshared03030201xml" indexer="include" status="PUBLISH">
36         <title xml-lang="en-US" id="tit">Hour Function [Runtime]</title>
37         <filename>/text/sbasic/shared/03030201.xhp</filename>
38      </topic>
39   </meta>
40   <body>
41      <section id="hour">
42<bookmark xml-lang="en-US" branch="index" id="bm_id3156042"><bookmark_value>Hour function</bookmark_value>
43</bookmark>
44<paragraph xml-lang="en-US" id="hd_id3156042" role="heading" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030201.xhp" name="Hour Function [Runtime]">Hour Function [Runtime]</link></paragraph>
45         <paragraph xml-lang="en-US" id="par_id3149346" role="paragraph" l10n="U" oldref="2">Returns the hour from a time value that is generated by the TimeSerial or the TimeValue function.</paragraph>
46      </section>
47      <paragraph xml-lang="en-US" id="hd_id3147574" role="heading" level="2" l10n="U" oldref="3">Syntax:</paragraph>
48      <paragraph xml-lang="en-US" id="par_id3147264" role="paragraph" l10n="U" oldref="4">Hour (Number)</paragraph>
49      <paragraph xml-lang="en-US" id="hd_id3145069" role="heading" level="2" l10n="U" oldref="5">Return value:</paragraph>
50      <paragraph xml-lang="en-US" id="par_id3149670" role="paragraph" l10n="U" oldref="6">Integer</paragraph>
51      <paragraph xml-lang="en-US" id="hd_id3150359" role="heading" level="2" l10n="U" oldref="7">Parameters:</paragraph>
52      <paragraph xml-lang="en-US" id="par_id3154366" role="paragraph" l10n="U" oldref="8">
53         <emph>Number:</emph> Numeric expression that contains the serial time value that is used to return the hour value.</paragraph>
54      <paragraph xml-lang="en-US" id="par_id3154909" role="paragraph" l10n="U" oldref="9">This function is the opposite of the <emph>TimeSerial</emph> function. It returns an integer value that represents the hour from a time value that is generated by the <emph>TimeSerial</emph> or the <emph>TimeValue </emph>function. For example, the expression</paragraph>
55      <paragraph xml-lang="en-US" id="par_id3163798" role="paragraph" l10n="CHG" oldref="10">Print Hour(TimeSerial(12,30,41))</paragraph>
56      <paragraph xml-lang="en-US" id="par_id3155132" role="paragraph" l10n="U" oldref="11">returns the value 12.</paragraph>
57      <embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
58      <embed href="text/sbasic/shared/00000003.xhp#err5"/>
59      <paragraph xml-lang="en-US" id="hd_id3147348" role="heading" level="2" l10n="U"
60                 oldref="12">Example:</paragraph>
61      <paragraph xml-lang="en-US" id="par_id3146985" role="paragraph" l10n="U" oldref="13">Sub ExampleHour</paragraph>
62      <paragraph xml-lang="en-US" id="par_id3156441" role="paragraph" l10n="U" oldref="14">Print "The current hour is " &amp; Hour( Now )</paragraph>
63      <paragraph xml-lang="en-US" id="par_id3153145" role="paragraph" l10n="U" oldref="15">End Sub</paragraph>
64   </body>
65</helpdocument>