1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
|
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<meta>
<topic id="textscalc0104060102xml" indexer="include">
<title id="tit" xml-lang="en-US">Date & Time Functions</title>
<filename>/text/scalc/01/04060102.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3154536"><bookmark_value>date and time functions</bookmark_value>
<bookmark_value>functions; date & time</bookmark_value>
<bookmark_value>Function Wizard; date & time</bookmark_value>
</bookmark>
<paragraph role="heading" id="hd_id3154536" xml-lang="en-US" level="1" l10n="U" oldref="1">Date & Time Functions</paragraph>
<paragraph role="paragraph" id="par_id3153973" xml-lang="en-US" l10n="U" oldref="2"><variable id="datumzeittext">These spreadsheet functions are used for inserting and editing dates and times.
</variable></paragraph>
<section id="howtoget">
<embed href="text/scalc/00/00000404.xhp#eikadaze"/>
</section>
<section id="ADD_note">
<paragraph role="note" id="par_idN10600" xml-lang="en-US" l10n="NEW">The functions whose names end with _ADD or _EXCEL2003 return the same results as the corresponding Microsoft Excel 2003 functions without the suffix. Use the functions without suffix to get results based on international standards.</paragraph>
</section>
<paragraph role="paragraph" id="par_id3150437" xml-lang="en-US" l10n="U" oldref="170">$[officename] internally handles a date/time value as a numerical value. If you assign the numbering format "Number" to a date or time value, it is converted to a number. For example, 01/01/2000 12:00 PM, converts to 36526.5. The value preceding the decimal point corresponds to the date; the value following the decimal point corresponds to the time. If you do not want to see this type of numerical date or time representation, change the number format (date or time) accordingly. To do this, select the cell containing the date or time value, call its context menu and select <emph>Format Cells</emph>. The <emph>Numbers</emph> tab page contains the functions for defining the number format.</paragraph>
<paragraph role="heading" id="hd_id2408825" xml-lang="en-US" level="2" l10n="NEW">Date base for day zero</paragraph>
<paragraph role="paragraph" id="par_id9988402" xml-lang="en-US" l10n="NEW">Dates are calculated as offsets from a starting day zero. You can set the day zero to be one of the following:</paragraph>
<table id="tbl_id1661427">
<tablerow>
<tablecell>
<paragraph role="tablehead" id="par_id6401257" xml-lang="en-US" l10n="NEW">Date base</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablehead" id="par_id5841242" xml-lang="en-US" l10n="NEW">Use</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id6794030" xml-lang="en-US" l10n="CHG">'12/30/1899'</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id7096774" xml-lang="en-US" l10n="NEW">(default)</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id5699942" xml-lang="en-US" l10n="CHG">'01/01/1900'</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id6420484" xml-lang="en-US" l10n="NEW">(used in former StarCalc 1.0)</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" id="par_id6986602" xml-lang="en-US" l10n="CHG">'01/01/1904'</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" id="par_id616779" xml-lang="en-US" l10n="NEW">(used in Apple software)</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph" id="par_id791039" xml-lang="en-US" l10n="NEW">Choose <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Calc - Calculate</emph> to select the date base.</paragraph>
<paragraph role="warning" id="par_id1953489" xml-lang="en-US" l10n="NEW">When you copy and paste cells containing date values between different spreadsheets, both spreadsheet documents must be set to the same date base. If date bases differ, the displayed date values will change!</paragraph>
<paragraph role="heading" id="hd_id757469" xml-lang="en-US" level="2" l10n="NEW">Two digits years</paragraph>
<paragraph role="paragraph" id="par_id3149720" xml-lang="en-US" l10n="U" oldref="183">In <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - $[officename] - General</emph> you find the area <emph>Year (two digits)</emph>. This sets the period for which two-digit information applies. Note that changes made here have an effect on some of the following functions.</paragraph>
<paragraph role="note" id="par_id3150654" xml-lang="en-US" l10n="U" oldref="185">When entering dates as part of formulas, slashes or dashes used as date separators are interpreted as arithmetic operators. Therefore, dates entered in this format are not recognized as dates and result in erroneous calculations. To keep dates from being interpreted as parts of formulas use the DATE function, for example, DATE(1954;7;20), or place the date in quotation marks and use the ISO 8601 notation, for example, "1954-07-20". Avoid using locale dependent date formats such as "07/20/54", the calculation may produce errors if the document is loaded under different locale settings.</paragraph>
<paragraph role="heading" id="par_idN1067A" xml-lang="en-US" level="2" l10n="NEW">Functions</paragraph>
<sort order="asc">
<section id="workday">
<paragraph role="paragraph" id="par_idN10683" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_workday.xhp#workday"/>
</paragraph>
</section>
<section id="yearfrac">
<paragraph role="paragraph" id="par_id5189062" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_yearfrac.xhp#yearfrac"/>
</paragraph>
</section>
<section id="date">
<paragraph role="paragraph" id="par_id6854457" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_date.xhp#date"/>
</paragraph>
</section>
<section id="datedif">
<paragraph role="paragraph" id="par_id6354457" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_datedif.xhp#datedif"/>
</paragraph>
</section>
<section id="datevalue">
<paragraph role="paragraph" id="par_id3372295" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_datevalue.xhp#datevalue"/>
</paragraph>
</section>
<section id="edate">
<paragraph role="paragraph" id="par_id5684377" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_edate.xhp#edate"/>
</paragraph>
</section>
<section id="today">
<paragraph role="paragraph" id="par_id7576525" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_today.xhp#today"/>
</paragraph>
</section>
<section id="year">
<paragraph role="paragraph" id="par_id641193" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_year.xhp#year"/>
</paragraph>
</section>
<section id="now">
<paragraph role="paragraph" id="par_id6501968" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_now.xhp#now"/>
</paragraph>
</section>
<section id="isoweeknum">
<paragraph role="paragraph" id="par_id3886533" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_isoweeknum.xhp#isoweeknum"/>
</paragraph>
</section>
<section id="weeknum">
<paragraph role="paragraph" id="par_id3886532" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_weeknum.xhp#weeknum"/>
</paragraph>
</section>
<section id="weeknum_ooo">
<paragraph role="paragraph" id="par_id3886534" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_weeknum_ooo.xhp#weeknum_ooo"/>
</paragraph>
</section>
<section id="weeknumadd">
<paragraph role="paragraph" id="par_id614947" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_weeknumadd.xhp#weeknumadd"/>
</paragraph>
</section>
<section id="minute">
<paragraph role="paragraph" id="par_id3953062" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_minute.xhp#minute"/>
</paragraph>
</section>
<section id="month">
<paragraph role="paragraph" id="par_id2579729" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_month.xhp#month"/>
</paragraph>
</section>
<section id="eomonth">
<paragraph role="paragraph" id="par_id1346781" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_eomonth.xhp#eomonth"/>
</paragraph>
</section>
<section id="networkdays">
<paragraph role="paragraph" id="par_id8951384" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_networkdays.xhp#networkdays"/>
</paragraph>
</section>
<section id="eastersunday">
<paragraph role="paragraph" id="par_id1074251" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_eastersunday.xhp#eastersunday"/>
</paragraph>
</section>
<section id="second">
<paragraph role="paragraph" id="par_id372325" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_second.xhp#second"/>
</paragraph>
</section>
<section id="hour">
<paragraph role="paragraph" id="par_id224005" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_hour.xhp#hour"/>
</paragraph>
</section>
<section id="day">
<paragraph role="paragraph" id="par_id5375835" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_day.xhp#day"/>
</paragraph>
</section>
<section id="days">
<paragraph role="paragraph" id="par_id1208838" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_days.xhp#days"/>
</paragraph>
</section>
<section id="days360">
<paragraph role="paragraph" id="par_id7679982" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_days360.xhp#days360"/>
</paragraph>
</section>
<section id="weekday">
<paragraph role="paragraph" id="par_id9172643" xml-lang="en-US" l10n="NEW" localize="false" >
<embedvar href="text/scalc/01/func_weekday.xhp#weekday"/>
</paragraph>
</section>
<section id="time">
<paragraph role="paragraph" id="par_id2354503" xml-lang="en-US" l10n="NEW" localize="false">
<embedvar href="text/scalc/01/func_time.xhp#time"/>
</paragraph>
</section>
<section id="timevalue">
<paragraph role="paragraph" id="par_id7765434" xml-lang="en-US" l10n="NEW" localize="false">
<embedvar href="text/scalc/01/func_timevalue.xhp#timevalue"/>
</paragraph>
</section>
</sort>
<section id="relatedtopics">
<embed href="text/scalc/01/04060100.xhp#drking"/>
</section>
</body>
</helpdocument>
|
