summaryrefslogtreecommitdiffstats
path: root/source/text/scalc/01/04060106.xhp
blob: a226f36372b71787f32c21ab478a9f1b43903e94 (plain)
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
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
<?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="textscalc0104060106xml" indexer="include">
    <title id="tit" xml-lang="en-US">Mathematical Functions</title>
    <filename>/text/scalc/01/04060106.xhp</filename>
  </topic>
</meta>

<body>

<bookmark xml-lang="en-US" branch="index" id="bm_id3147124">
  <bookmark_value>mathematical functions</bookmark_value>
  <bookmark_value>Function Wizard; mathematical</bookmark_value>
  <bookmark_value>functions; mathematical functions</bookmark_value>
  <bookmark_value>trigonometric functions</bookmark_value>
</bookmark>


<h1 id="hd_id3147124">Mathematical Functions</h1>
<paragraph id="par_id3154943" role="paragraph" xml-lang="en-US"><variable id="mathematiktext">This category contains the <emph>Mathematical</emph> functions for Calc.</variable> To open the <emph>Function Wizard</emph>, choose <link href="text/scalc/01/04060000.xhp" name="Insert - Function"><emph>Insert - Function</emph></link>.</paragraph>
<sort>

<section id="Section1">
<bookmark xml-lang="en-US" branch="index" id="bm_id3146944">
  <bookmark_value>ABS function</bookmark_value>
  <bookmark_value>absolute values</bookmark_value>
  <bookmark_value>values;absolute</bookmark_value>
</bookmark>
<comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ABS" id="bm_id3150695" localize="false"/>

<h2 id="hd_id3146944">ABS</h2>
<paragraph id="par_id3154546" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ABS">Returns the absolute value of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3147475" role="code" xml-lang="en-US">ABS(Number)</paragraph>
<paragraph id="par_id3148438" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number whose absolute value is to be calculated. The absolute value of a number is its value without the +/- sign.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3152787" role="paragraph" xml-lang="en-US"><item type="input">=ABS(-56)</item> returns 56.</paragraph>
<paragraph id="par_id3148752" role="paragraph" xml-lang="en-US"><item type="input">=ABS(12)</item> returns 12.</paragraph>
<paragraph id="par_id320139" role="paragraph" xml-lang="en-US"><item type="input">=ABS(0)</item> returns 0.<comment>see also SIGN</comment></paragraph>
</section>

<section id="Section61">
<bookmark xml-lang="en-US" branch="index" id="bm_id3153114">
  <bookmark_value>ACOS function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCCOS" id="bm_id3155952" localize="false"/>

<h2 id="hd_id3153114">ACOS</h2>
<paragraph id="par_id3145163" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCCOS">Returns the inverse trigonometric cosine of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3150020" role="code" xml-lang="en-US">ACOS(Number)</paragraph>
<paragraph id="par_id3159134" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric cosine of <emph>Number</emph>, that is the angle (in radians) whose cosine is Number. The angle returned is between 0 and PI.</paragraph>
<paragraph id="par_id679647" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3150128" role="paragraph" xml-lang="en-US"><item type="input">=ACOS(-1)</item> returns 3.14159265358979 (PI radians)</paragraph>
<paragraph id="par_id8792382" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ACOS(0.5))</item> returns 60. The cosine of 60 degrees is 0.5.</paragraph><comment>see also COS, SIN, TAN, COT, ASIN, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section60">
<bookmark xml-lang="en-US" branch="index" id="bm_id3145355">
  <bookmark_value>ACOSH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCOSHYP" id="bm_id3148386" localize="false"/>

<h2 id="hd_id3145355">ACOSH</h2>
<paragraph id="par_id3157993" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCOSHYP">Returns the inverse hyperbolic cosine of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3151017" role="code" xml-lang="en-US">ACOSH(Number)</paragraph>
<paragraph id="par_id3149000" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic cosine of <emph>Number</emph>, that is the number whose hyperbolic cosine is Number.</paragraph>
<paragraph id="par_id6393932" role="paragraph" xml-lang="en-US">Number must be greater than or equal to 1.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3145629" role="paragraph" xml-lang="en-US"><item type="input">=ACOSH(1)</item> returns 0.</paragraph>
<paragraph id="par_id951567" role="paragraph" xml-lang="en-US"><item type="input">=ACOSH(COSH(4))</item> returns 4.</paragraph><comment>see also ASINH, ATANH, ACOTH, COSH, SINH, TANH, COTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section59">
<bookmark xml-lang="en-US" branch="index" id="bm_id3149027">
  <bookmark_value>ACOT function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCCOT" id="bm_id3154634" localize="false"/>

<h2 id="hd_id3149027">ACOT</h2>
<paragraph id="par_id3155818" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCCOT">Returns the inverse cotangent (the arccotangent) of the given number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3158419" role="code" xml-lang="en-US">ACOT(Number)</paragraph>
<paragraph id="par_id3154948" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric cotangent of <emph>Number</emph>, that is the angle (in radians) whose cotangent is Number. The angle returned is between 0 and PI.</paragraph>
<paragraph id="par_id5834528" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3155375" role="paragraph" xml-lang="en-US"><item type="input">=ACOT(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph>
<paragraph id="par_id8589434" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ACOT(1))</item> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section58">
<bookmark xml-lang="en-US" branch="index" id="bm_id3148426">
  <bookmark_value>ACOTH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCOTHYP" id="bm_id3149777" localize="false"/>

<h2 id="hd_id3148426">ACOTH</h2>
<paragraph id="par_id3147478" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCOTHYP">Returns the inverse hyperbolic cotangent of the given number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3147172" role="code" xml-lang="en-US">ACOTH(Number)</paragraph>
<paragraph id="par_id3146155" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic cotangent of <emph>Number</emph>, that is the number whose hyperbolic cotangent is Number.</paragraph>
<paragraph id="par_id5818659" role="paragraph" xml-lang="en-US">An error results if Number is between -1 and 1 inclusive.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3150608" role="paragraph" xml-lang="en-US"><item type="input">=ACOTH(1.1)</item> returns inverse hyperbolic cotangent of 1.1, approximately 1.52226.</paragraph><comment>see also ACOSH, ASINH, ATANH, COSH, SINH, TANH, COTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="aggregate">

<h2 id="hd_id7145084" localize="false"><embedvar href="text/scalc/01/func_aggregate.xhp#aggregate_head"/></h2>
<paragraph id="par_id323373151810412" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_aggregate.xhp#aggregate_des"/></paragraph>
</section>

<section id="Section57">
<bookmark xml-lang="en-US" branch="index" id="bm_id3145084">
  <bookmark_value>ASIN function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCSIN" id="bm_id3149280" localize="false"/>

<h2 id="hd_id3145084">ASIN</h2>
<paragraph id="par_id3156296" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCSIN">Returns the inverse trigonometric sine of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3156305" role="code" xml-lang="en-US">ASIN(Number)</paragraph>
<paragraph id="par_id3150964" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric sine of <emph>Number</emph>, that is the angle (in radians) whose sine is Number. The angle returned is between -PI/2 and +PI/2.</paragraph>
<paragraph id="par_id203863" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3156100" role="paragraph" xml-lang="en-US"><item type="input">=ASIN(0)</item> returns 0.</paragraph>
<paragraph id="par_id6853846" role="paragraph" xml-lang="en-US"><item type="input">=ASIN(1)</item> returns 1.5707963267949 (PI/2 radians).</paragraph>
<paragraph id="par_id8772240" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ASIN(0.5))</item> returns 30. The sine of 30 degrees is 0.5.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section56">
<bookmark xml-lang="en-US" branch="index" id="bm_id3151266">
  <bookmark_value>ASINH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARSINHYP" id="bm_id3145206" localize="false"/>

<h2 id="hd_id3151266">ASINH</h2>
<paragraph id="par_id3147077" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARSINHYP">Returns the inverse hyperbolic sine of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3150882" role="code" xml-lang="en-US">ASINH(Number)</paragraph>
<paragraph id="par_id3147621" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic sine of <emph>Number</emph>, that is the number whose hyperbolic sine is Number.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3156120" role="paragraph" xml-lang="en-US"><item type="input">=ASINH(-90)</item> returns approximately -5.1929877.</paragraph>
<paragraph id="par_id4808496" role="paragraph" xml-lang="en-US"><item type="input">=ASINH(SINH(4))</item> returns 4.</paragraph><comment>see also ACOSH, ATANH, ACOTH, COSH, SINH, TANH, COTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section55">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155996">
  <bookmark_value>ATAN function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCTAN" id="bm_id3154743" localize="false"/>

<h2 id="hd_id3155996">ATAN</h2>
<paragraph id="par_id3149985" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCTAN">Returns the inverse trigonometric tangent of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3150261" role="code" xml-lang="en-US">ATAN(Number)</paragraph>
<paragraph id="par_id3147267" role="paragraph" xml-lang="en-US">This function returns the inverse trigonometric tangent of <emph>Number</emph>, that is the angle (in radians) whose tangent is Number. The angle returned is between -PI/2 and PI/2.</paragraph>
<paragraph id="par_id6293527" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3143229" role="paragraph" xml-lang="en-US"><item type="input">=ATAN(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph>
<paragraph id="par_id8746299" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(ATAN(1))</item> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section54">
<bookmark xml-lang="en-US" branch="index" id="bm_id3153983">
  <bookmark_value>ATAN2 function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCTAN2" id="bm_id3159180" localize="false"/>

<h2 id="hd_id3153983">ATAN2</h2>
<paragraph id="par_id3154297" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCTAN2">Returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY).</ahelp></paragraph>
<embed href="text/scalc/01/ODFF.xhp#odff"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3156013" role="code" xml-lang="en-US">ATAN2(NumberX; NumberY)</paragraph>
<paragraph id="par_id3001800" role="paragraph" xml-lang="en-US"><emph>NumberX</emph> is the value of the x coordinate.</paragraph>
<paragraph id="par_id3152798" role="paragraph" xml-lang="en-US"><emph>NumberY</emph> is the value of the y coordinate.</paragraph>
<tip id="par_id5036168">Programming languages have usually the opposite order of arguments for their atan2() function.</tip>
<paragraph id="par_id5036165" role="paragraph" xml-lang="en-US">ATAN2 returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY)</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3154692" role="paragraph" xml-lang="en-US"><item type="input">=ATAN2(-5;9)</item> returns 2.07789 radians.</paragraph>

<paragraph id="par_id5036166" role="paragraph" xml-lang="en-US">To get the angle in degrees apply the DEGREES function to the result.</paragraph>
<paragraph id="par_id1477095" role="paragraph" xml-lang="en-US"><input>=DEGREES(ATAN2(12.3;12.3))</input> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ACOT</comment>
<note id="par_id5036167">%PRODUCTNAME results 0 for ATAN2(0;0).</note>

<paragraph id="par_id5036169" role="paragraph" xml-lang="en-US">The function can be used in converting cartesian coordinates to polar coordinates.</paragraph>
<paragraph id="par_id5036170" role="paragraph" xml-lang="en-US">=DEGREES(ATAN2(-8;5)) returns φ =  147.9 degrees</paragraph>
<paragraph role="paragraph" id="par_id5036171" xml-lang="en-US">
<image id="img_id3150758" src="media/helpimg/scalc/coordinates-to-polar-01.svg" width="2.5inch" height="1.5inch"><alt id="alt_id3150758" xml-lang="en-US">Cartesian coordinates to polar coordinates example</alt></image>
</paragraph>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section53">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155398">
  <bookmark_value>ATANH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARTANHYP" id="bm_id3154939" localize="false"/>

<h2 id="hd_id3155398">ATANH</h2>
<paragraph id="par_id3148829" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARTANHYP">Returns the inverse hyperbolic tangent of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3149912" role="code" xml-lang="en-US">ATANH(Number)</paragraph>
<paragraph id="par_id3150521" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic tangent of <emph>Number</emph>, that is the number whose hyperbolic tangent is Number.</paragraph>
<paragraph id="par_id9357280" role="paragraph" xml-lang="en-US">Number must obey the condition -1 &lt; number &lt; 1.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3145419" role="paragraph" xml-lang="en-US"><item type="input">=ATANH(0)</item> returns 0.</paragraph><comment>see also ACOSH, ASINH, ACOTH, COSH, SINH, TANH, COTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section52">
<bookmark xml-lang="en-US" branch="index" id="bm_id3153062">
  <bookmark_value>COS function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COS" id="bm_id3158408" localize="false"/>

<h2 id="hd_id3153062">COS</h2>
<paragraph id="par_id3148803" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COS">Returns the cosine of the given angle (in radians).</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3154213" role="code" xml-lang="en-US">COS(Number)</paragraph>
<paragraph id="par_id3154285" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cosine of <emph>Number</emph>, the angle in radians.</paragraph>
<paragraph id="par_id831019" role="paragraph" xml-lang="en-US">To return the cosine of an angle in degrees, use the RADIANS function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3147241" role="paragraph" xml-lang="en-US"><item type="input">=COS(PI()*2)</item> returns 1, the cosine of 2*PI radians.</paragraph>
<paragraph id="par_id3147516" role="paragraph" xml-lang="en-US"><item type="input">=COS(RADIANS(60))</item> returns 0.5, the cosine of 60 degrees.</paragraph><comment>see also SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section51">
<bookmark xml-lang="en-US" branch="index" id="bm_id3154277">
  <bookmark_value>COSH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSHYP" id="bm_id3149158" localize="false"/>

<h2 id="hd_id3154277">COSH</h2>
<paragraph id="par_id3146946" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSHYP">Returns the hyperbolic cosine of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3166440" role="code" xml-lang="en-US">COSH(Number)</paragraph>
<paragraph id="par_id3150710" role="paragraph" xml-lang="en-US">Returns the hyperbolic cosine of <emph>Number</emph>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3154099" role="paragraph" xml-lang="en-US"><item type="input">=COSH(0)</item> returns 1, the hyperbolic cosine of 0.</paragraph><comment>see also SINH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section50">
<bookmark xml-lang="en-US" branch="index" id="bm_id3152888">
  <bookmark_value>COT function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COT" id="bm_id3153392" localize="false"/>

<h2 id="hd_id3152888">COT</h2>
<paragraph id="par_id3153679" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COT">Returns the cotangent of the given angle (in radians).</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3154856" role="code" xml-lang="en-US">COT(Number)</paragraph>
<paragraph id="par_id3149969" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cotangent of <emph>Number</emph>, the angle in radians.</paragraph>
<paragraph id="par_id3444624" role="paragraph" xml-lang="en-US">To return the cotangent of an angle in degrees, use the RADIANS function.</paragraph>
<paragraph id="par_id6814477" role="paragraph" xml-lang="en-US">The cotangent of an angle is equivalent to 1 divided by the tangent of that angle.</paragraph>

<h3 id="hd_id3149800">Examples:</h3>
<paragraph id="par_id3148616" role="paragraph" xml-lang="en-US"><item type="input">=COT(PI()/4)</item> returns 1, the cotangent of PI/4 radians.</paragraph>
<paragraph id="par_id3148986" role="paragraph" xml-lang="en-US"><item type="input">=COT(RADIANS(45))</item> returns 1, the cotangent of 45 degrees.</paragraph><comment>see also COS, SIN, TAN, ACOS, ASIN, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section49">
<bookmark xml-lang="en-US" branch="index" id="bm_id3154337">
  <bookmark_value>COTH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COTHYP" id="bm_id3148650" localize="false"/>

<h2 id="hd_id3154337">COTH</h2>
<paragraph id="par_id3149419" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COTHYP">Returns the hyperbolic cotangent of a given number (angle).</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3143280" role="code" xml-lang="en-US">COTH(Number)</paragraph>
<paragraph id="par_id3154799" role="paragraph" xml-lang="en-US">Returns the hyperbolic cotangent of <emph>Number</emph>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3144754" role="paragraph" xml-lang="en-US"><item type="input">=COTH(1)</item> returns the hyperbolic cotangent of 1, approximately 1.3130.</paragraph><comment>see also COSH, SINH, TANH, ACOSH, ASINH, ATANH, ACOTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section64">
<bookmark xml-lang="en-US" branch="index" id="bm_id6110552">
  <bookmark_value>CSC function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSECANT" id="bm_id5645316" localize="false"/>

<h2 id="hd_id9523234">CSC</h2>
<paragraph id="par_id4896433" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSECANT">Returns the cosecant of the given angle (in radians). The cosecant of an angle is equivalent to 1 divided by the sine of that angle</ahelp></paragraph>
<embed href="text/scalc/00/avail_release.xhp#3.5"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id4571344" role="code" xml-lang="en-US">CSC(Number)</paragraph>
<paragraph id="par_id9859164" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cosecant of <emph>Number</emph>, the angle in radians.</paragraph>
<paragraph id="par_id3428494" role="paragraph" xml-lang="en-US">To return the cosecant of an angle in degrees, use the RADIANS function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3736803" role="paragraph" xml-lang="en-US"><item type="input">=CSC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the sine of PI/4 radians.</paragraph>
<paragraph id="par_id6016818" role="paragraph" xml-lang="en-US"><item type="input">=CSC(RADIANS(30))</item> returns 2, the cosecant of 30 degrees.</paragraph><comment>see also SIN, TAN, COT, SEC, ACOS, ASIN, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section66">
<bookmark xml-lang="en-US" branch="index" id="bm_id9288877">
  <bookmark_value>CSCH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSECANTHYP" id="bm_id9532490" localize="false"/>

<h2 id="hd_id4325650">CSCH</h2>
<paragraph id="par_id579916" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSECANTHYP">Returns the hyperbolic cosecant of a number.</ahelp></paragraph>
<embed href="text/scalc/00/avail_release.xhp#3.5"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3108851" role="code" xml-lang="en-US">CSCH(Number)</paragraph>
<paragraph id="par_id1394188" role="paragraph" xml-lang="en-US">Returns the hyperbolic cosecant of <emph>Number</emph>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id5426085" role="paragraph" xml-lang="en-US"><item type="input">=CSCH(1)</item> returns approximately 0.8509181282, the hyperbolic cosecant of 1.</paragraph><comment>see also SINH, TANH, COTH, SECH,ACOSH, ASINH, ATANH, ACOTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section48">
<bookmark xml-lang="en-US" branch="index" id="bm_id3145314">
  <bookmark_value>DEGREES function</bookmark_value>
  <bookmark_value>converting;radians, into degrees</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DEG" id="bm_id3153946" localize="false"/>

<h2 id="hd_id3145314">DEGREES</h2>
<paragraph id="par_id3149939" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DEG">Converts radians into degrees.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3145600" role="code" xml-lang="en-US">DEGREES(Number)</paragraph>
<paragraph id="par_id3149484" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the angle in radians to be converted to degrees.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3459578" role="paragraph" xml-lang="en-US"><item type="input">=DEGREES(PI())</item> returns 180 degrees.</paragraph><comment>see also RADIANS</comment>
</section>

<section id="Section47">
<bookmark xml-lang="en-US" branch="index" id="bm_id3148698">
  <bookmark_value>EXP function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EXP" id="bm_id3154625" localize="false"/>

<h2 id="hd_id3148698">EXP</h2>
<paragraph id="par_id3150592" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXP">Returns <literal>e</literal> raised to the power of a number.</ahelp> The constant <literal>e</literal> has a value of approximately 2.71828182845904.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3146786" role="code" xml-lang="en-US">EXP(Number)</paragraph>
<paragraph id="par_id3155608" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the power to which e is to be raised.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3156340" role="paragraph" xml-lang="en-US"><item type="input">=EXP(1)</item> returns 2.71828182845904, the mathematical constant <literal>e</literal> to Calc's accuracy.</paragraph><comment>see also POWER, LN</comment>
</section>

<section id="Section46">
<bookmark xml-lang="en-US" branch="index" id="bm_id3145781">
  <bookmark_value>FACT function</bookmark_value>
  <bookmark_value>factorials;numbers</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FAKULTAET" id="bm_id3153886" localize="false"/>

<h2 id="hd_id3145781">FACT</h2>
<paragraph id="par_id3151109" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FAKULTAET">Returns the factorial of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3154661" role="code" xml-lang="en-US">FACT(Number)</paragraph>
<paragraph id="par_id3152952" role="paragraph" xml-lang="en-US">Returns Number!, the factorial of <emph>Number</emph>, calculated as 1*2*3*4* ... * Number.</paragraph>
<paragraph id="par_id3834650" role="paragraph" xml-lang="en-US">=FACT(0) returns 1 by definition.</paragraph>
<paragraph id="par_id8429517" role="paragraph" xml-lang="en-US">The factorial of a negative number returns the "invalid argument" error.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3154476" role="paragraph" xml-lang="en-US"><item type="input">=FACT(3)</item> returns 6.</paragraph>
<paragraph id="par_id3147525" role="paragraph" xml-lang="en-US"><item type="input">=FACT(0)</item> returns 1.</paragraph><comment>see also FACTDOUBLE, MULTINOMIAL, PRODUCT</comment>
</section>

<section id="Section45">
<bookmark xml-lang="en-US" branch="index" id="bm_id3159084">
  <bookmark_value>INT function</bookmark_value>
  <bookmark_value>numbers;rounding down to next integer</bookmark_value>
  <bookmark_value>rounding;down to next integer</bookmark_value>
</bookmark>
<comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GANZZAHL" id="bm_id3151311" localize="false"/>

<h2 id="hd_id3159084">INT</h2>
<paragraph id="par_id3158441" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GANZZAHL">Rounds a number down to the nearest integer.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3156146" role="code" xml-lang="en-US">INT(Number)</paragraph>
<paragraph id="par_id3154117" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded down to the nearest integer.</paragraph>
<paragraph id="par_id153508" role="paragraph" xml-lang="en-US">Negative numbers round down to the integer below.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3156267" role="paragraph" xml-lang="en-US"><item type="input">=INT(5.7)</item> returns 5.</paragraph>
<paragraph id="par_id3147323" role="paragraph" xml-lang="en-US"><item type="input">=INT(-1.3)</item> returns -2.</paragraph><comment>see also TRUNC, ROUND, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND</comment>
</section>

<section id="Section44">
<bookmark xml-lang="en-US" branch="index" id="bm_id3150938">
  <bookmark_value>EVEN function</bookmark_value>
  <bookmark_value>numbers;rounding up/down to even integers</bookmark_value>
  <bookmark_value>rounding;up/down to even integers</bookmark_value>
</bookmark>
<comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GERADE" id="bm_id3150949" localize="false"/>

<h2 id="hd_id3150938">EVEN</h2>
<paragraph id="par_id3149988" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GERADE">Rounds a positive number up to the next even integer and a negative number down to the next even integer.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3150830" role="code" xml-lang="en-US">EVEN(Number)</paragraph>
<paragraph id="par_id3153350" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the next even integer up, away from zero.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3154361" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(2.3)</item> returns 4.</paragraph>
<paragraph id="par_id8477736" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(2)</item> returns 2.</paragraph>
<paragraph id="par_id159611" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(0)</item> returns 0.</paragraph>
<paragraph id="par_id6097598" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(-0.5)</item> returns -2.</paragraph><comment>see also CEILING, FLOOR, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment>
</section>

<section id="Section43">
<bookmark xml-lang="en-US" branch="index" id="bm_id3147356">
  <bookmark_value>GCD function</bookmark_value>
  <bookmark_value>greatest common divisor</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GGT" id="bm_id3149737" localize="false"/>

<h2 id="hd_id3147356">GCD</h2>
<paragraph id="par_id3152465" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GGT">Returns the greatest common divisor of two or more integers.</ahelp></paragraph>
<paragraph id="par_id2769249" role="paragraph" xml-lang="en-US">The greatest common divisor is the positive largest integer which will divide, without remainder, each of the given integers.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3154524" role="code" xml-lang="en-US">GCD(<embedvar href="text/scalc/01/ful_func.xhp#integer255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#integer255"/>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3151285" role="paragraph" xml-lang="en-US"><item type="input">=GCD(16;32;24) </item>gives the result 8, because 8 is the largest number that can divide 16, 24 and 32 without a remainder.</paragraph>
<paragraph id="par_id1604663" role="paragraph" xml-lang="en-US"><item type="input">=GCD(B1:B3)</item> where cells B1, B2, B3 contain <item type="input">9</item>, <item type="input">12</item>, <item type="input">9</item> gives 3.</paragraph>
</section>

<section id="Section42">
<bookmark xml-lang="en-US" branch="index" id="bm_id3151221">
  <bookmark_value>GCD_EXCEL2003 function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_GCD" id="bm_id3147578" localize="false"/>
<h2 id="hd_id3151221">GCD_EXCEL2003</h2>
<paragraph id="par_id3153257" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_GCD">The result is the greatest common divisor of a list of numbers.</ahelp></paragraph>
<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3156205" role="code" xml-lang="en-US">GCD_EXCEL2003(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#number255"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3159192" role="paragraph" xml-lang="en-US"><item type="input">=GCD_EXCEL2003(5;15;25)</item> returns 5.</paragraph>
</section>

<section id="Section39">
<bookmark xml-lang="en-US" branch="index" id="bm_id3145213">
  <bookmark_value>LCM function</bookmark_value>
  <bookmark_value>least common multiples</bookmark_value>
  <bookmark_value>lowest common multiples</bookmark_value>
</bookmark>
<comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KGV" id="bm_id3145225" localize="false"/>

<h2 id="hd_id3145213">LCM</h2>
<paragraph id="par_id3146814" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KGV">Returns the least common multiple of one or more integers.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3147279" role="code" xml-lang="en-US">LCM(<embedvar href="text/scalc/01/ful_func.xhp#integer255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#integer255"/>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3154914" role="paragraph" xml-lang="en-US">If you enter the numbers 512; 1024 and 2000 as Integer 1;2 and 3, then 128000 will be returned.</paragraph>
</section>

<section id="Section38">
<bookmark xml-lang="en-US" branch="index" id="bm_id3154230">
  <bookmark_value>LCM_EXCEL2003 function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_LCM" id="bm_id3147222" localize="false"/>
<h2 id="hd_id3154230">LCM_EXCEL2003</h2>
<paragraph id="par_id3149036" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_LCM">The result is the lowest common multiple of a list of numbers.</ahelp></paragraph>
<embed href="text/scalc/01/04060102.xhp#ADD_note"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3154395" role="code" xml-lang="en-US">LCM_EXCEL2003(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#number255"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3145135" role="paragraph" xml-lang="en-US"><item type="input">=LCM_EXCEL2003(5;15;25)</item> returns 75.</paragraph>
</section>

<section id="Section37">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155802">
  <bookmark_value>COMBIN function</bookmark_value>
  <bookmark_value>number of combinations</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOMBINATIONEN" id="bm_id3155077" localize="false"/><comment>should be statistical--&gt;add a link there</comment>

<h2 id="hd_id3155802">COMBIN</h2>
<paragraph id="par_id3156172" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KOMBINATIONEN">Returns the number of combinations for elements without repetition.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3150223" role="code" xml-lang="en-US">COMBIN(Count1; Count2)</paragraph>
<paragraph id="par_id3150313" role="paragraph" xml-lang="en-US"><emph>Count1</emph> is the number of items in the set.</paragraph>
<paragraph id="par_id3153830" role="paragraph" xml-lang="en-US"><emph>Count2</emph> is the number of items to choose from the set.</paragraph>
<paragraph id="par_id6807458" role="paragraph" xml-lang="en-US">COMBIN returns the number of ordered ways to choose these items. For example if there are 3 items A, B and C in a set, you can choose 2 items in 3 different ways, namely AB, AC and BC.</paragraph>
<paragraph id="par_id7414471" role="paragraph" xml-lang="en-US">COMBIN implements the formula: Count1!/(Count2!*(Count1-Count2)!)</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3153517" role="paragraph" xml-lang="en-US"><item type="input">=COMBIN(3;2)</item> returns 3.</paragraph><comment>see also COMBINA</comment>
</section>

<section id="Section36">
<bookmark xml-lang="en-US" branch="index" id="bm_id3150284">
  <bookmark_value>COMBINA function</bookmark_value>
  <bookmark_value>number of combinations with repetitions</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOMBINATIONEN2" id="bm_id3150295" localize="false"/><comment>should be statistical--&gt;add a link there</comment>

<h2 id="hd_id3150284">COMBINA</h2>
<paragraph id="par_id3157894" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KOMBINATIONEN2">Returns the number of combinations of a subset of items including repetitions.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3145765" role="code" xml-lang="en-US">COMBINA(Count1; Count2)</paragraph>
<paragraph id="par_id3153372" role="paragraph" xml-lang="en-US"><emph>Count1</emph> is the number of items in the set.</paragraph>
<paragraph id="par_id3155544" role="paragraph" xml-lang="en-US"><emph>Count2</emph> is the number of items to choose from the set.</paragraph>
<paragraph id="par_id1997131" role="paragraph" xml-lang="en-US">COMBINA returns the number of unique ways to choose these items, where the order of choosing is irrelevant, and repetition of items is allowed. For example if there are 3 items A, B and C in a set, you can choose 2 items in 6 different ways, namely AA, AB, AC, BB, BC and CC.</paragraph>
<paragraph id="par_id2052064" role="paragraph" xml-lang="en-US">COMBINA implements the formula: (Count1+Count2-1)! / (Count2!(Count1-1)!)<comment>i88052</comment></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3152904" role="paragraph" xml-lang="en-US"><item type="input">=COMBINA(3;2)</item> returns 6.</paragraph><comment>see also COMBIN</comment>
</section>

<section id="Section35">
<bookmark xml-lang="en-US" branch="index" id="bm_id3156086">
  <bookmark_value>TRUNC function</bookmark_value>
  <bookmark_value>decimal places;cutting off</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUERZEN" id="bm_id3157849" localize="false"/>

<h2 id="hd_id3156086">TRUNC</h2>
<paragraph id="par_id3157866" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KUERZEN">Truncates a number by removing decimal places.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3148511" role="code" xml-lang="en-US">TRUNC(Number; Count)</paragraph>
<paragraph id="par_id3150796" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> with at most <emph>Count</emph> decimal places. Excess decimal places are simply removed, irrespective of sign.</paragraph>
<paragraph id="par_id3150816" role="paragraph" xml-lang="en-US"><item type="literal">TRUNC(Number; 0)</item> behaves as <item type="literal">INT(Number)</item> for positive numbers, but effectively rounds towards zero for negative numbers.</paragraph>
<warning id="par_id3148548">The <emph>visible</emph> decimal places of the result are specified in <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences
</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01060500.xhp">%PRODUCTNAME Calc - Calculate</link>.</warning>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3152569" role="paragraph" xml-lang="en-US"><item type="input">=TRUNC(1.239;2)</item> returns 1.23. The 9 is lost.</paragraph>
<paragraph id="par_id7050080" role="paragraph" xml-lang="en-US"><item type="input">=TRUNC(-1.234999;3)</item> returns -1.234. All the 9s are lost.</paragraph><comment>see also INT, ROUND, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND</comment>
</section>

<section id="Section34">
<bookmark xml-lang="en-US" branch="index" id="bm_id3153601">
  <bookmark_value>LN function</bookmark_value>
  <bookmark_value>natural logarithm</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LN" id="bm_id3153613" localize="false"/>

<h2 id="hd_id3153601">LN</h2>
<paragraph id="par_id3154974" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LN">Returns the natural logarithm based on the constant e of a number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3155284" role="code" xml-lang="en-US">LN(Number)</paragraph>
<paragraph id="par_id3155297" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value whose natural logarithm is to be calculated.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3153866" role="paragraph" xml-lang="en-US"><item type="input">=LN(3)</item> returns the natural logarithm of 3 (approximately 1.0986).</paragraph>
<paragraph id="par_id5747245" role="paragraph" xml-lang="en-US"><item type="input">=LN(EXP(321))</item> returns 321.</paragraph><comment>see also LOG, LOG10, EXP</comment>
</section>

<section id="Section33">
<bookmark xml-lang="en-US" branch="index" id="bm_id3109813">
  <bookmark_value>LOG function</bookmark_value>
  <bookmark_value>logarithms</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOG" id="bm_id3109824" localize="false"/>

<h2 id="hd_id3109813">LOG</h2>
<paragraph id="par_id3109841" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LOG">Returns the logarithm of a number to the specified base.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3144732" role="code" xml-lang="en-US">LOG(Number; Base)</paragraph>
<paragraph id="par_id3144746" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value whose logarithm is to be calculated.</paragraph>
<paragraph id="par_id3152840" role="paragraph" xml-lang="en-US"><emph>Base</emph> (optional) is the base for the logarithm calculation. If omitted, Base 10 is assumed.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3154429" role="paragraph" xml-lang="en-US"><item type="input">=LOG(10;3)</item> returns the logarithm to base 3 of 10 (approximately 2.0959).</paragraph>
<paragraph id="par_id5577562" role="paragraph" xml-lang="en-US"><item type="input">=LOG(7^4;7)</item> returns 4.</paragraph><comment>see also LOG10, LN, POWER</comment>
</section>

<section id="Section32">
<bookmark xml-lang="en-US" branch="index" id="bm_id3154187">
  <bookmark_value>LOG10 function</bookmark_value>
  <bookmark_value>base-10 logarithm</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOG10" id="bm_id3155460" localize="false"/>

<h2 id="hd_id3154187">LOG10</h2>
<paragraph id="par_id3155476" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LOG10">Returns the base-10 logarithm of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3159294" role="code" xml-lang="en-US">LOG10(Number)</paragraph>
<paragraph id="par_id3159308" role="paragraph" xml-lang="en-US">Returns the logarithm to base 10 of <emph>Number</emph>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3157916" role="paragraph" xml-lang="en-US"><item type="input">=LOG10(5)</item> returns the base-10 logarithm of 5 (approximately 0.69897).</paragraph><comment>see also LOG, LN, POWER</comment>
</section>


<section id="Section30">
<bookmark xml-lang="en-US" branch="index" id="bm_id3157762">
  <bookmark_value>PI function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PI" id="bm_id3157774" localize="false"/>

<h2 id="hd_id3157762">PI</h2>
<paragraph id="par_id3157790" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_PI">Returns 3.14159265358979, the value of the mathematical constant PI to 14 decimal places.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3157822" role="code" xml-lang="en-US">PI()</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3152370" role="paragraph" xml-lang="en-US"><item type="input">=PI()</item> returns 3.14159265358979.</paragraph>
</section>

<section id="Section29">
<bookmark xml-lang="en-US" branch="index" id="bm_id3152418">
  <bookmark_value>MULTINOMIAL function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MULTINOMIAL" id="bm_id3152429" localize="false"/>
<h2 id="hd_id3152418">MULTINOMIAL</h2>
<paragraph id="par_id3152454" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MULTINOMIAL">Returns the factorial of the sum of the arguments divided by the product of the factorials of the arguments.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3155660" role="code" xml-lang="en-US">MULTINOMIAL(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#number255"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3155701" role="paragraph" xml-lang="en-US"><item type="input">=MULTINOMIAL(F11:H11)</item> returns 1260, if F11 to H11 contain the values <item type="input">2</item>, <item type="input">3</item> and <item type="input">4</item>. This corresponds to the formula =(2+3+4)! / (2!*3!*4!)</paragraph>
</section>

<section id="Section28">
<bookmark xml-lang="en-US" branch="index" id="bm_id3155717">
  <bookmark_value>POWER function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_POTENZ" id="bm_id3155728" localize="false"/>

<h2 id="hd_id3155717">POWER</h2>
<paragraph id="par_id3159495" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_POTENZ">Returns a number raised to another number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3159526" role="code" xml-lang="en-US">POWER(Base; Exponent)</paragraph>
<paragraph id="par_id3159540" role="paragraph" xml-lang="en-US">Returns <emph>Base</emph> raised to the power of <emph>Exponent</emph>.</paragraph>
<paragraph id="par_id5081637" role="paragraph" xml-lang="en-US">The same result may be achieved by using the exponentiation operator ^:</paragraph>
<paragraph id="par_id9759514" role="code" xml-lang="en-US"><item type="literal">Base^Exponent</item></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3159594" role="paragraph" xml-lang="en-US"><item type="input">=POWER(4;3)</item> returns 64, which is 4 to the power of 3.</paragraph>
<paragraph id="par_id1614429" role="paragraph" xml-lang="en-US">=4^3 also returns 4 to the power of 3.</paragraph><comment>see also EXP, LOG, SQRT</comment>
</section>

<section id="Section27">
<bookmark xml-lang="en-US" branch="index" id="bm_id3152651">
  <bookmark_value>SERIESSUM function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_SERIESSUM" id="bm_id3152662" localize="false"/>

<h2 id="hd_id3152651">SERIESSUM</h2>
<paragraph id="par_id3152688" role="paragraph" xml-lang="en-US"><ahelp hid=".">Sums the first terms of a power series.</ahelp></paragraph>
<paragraph id="par_id3152708" role="paragraph" xml-lang="en-US">SERIESSUM(x;n;m;coefficients) = coefficient_1*x^n + coefficient_2*x^(n+m) + coefficient_3*x^(n+2m) +...+ coefficient_i*x^(n+(i-1)m)</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_idN11BD9" role="code" xml-lang="en-US">SERIESSUM(X; N; M; Coefficients)</paragraph>
<paragraph id="par_id3152737" role="paragraph" xml-lang="en-US"><emph>X</emph> is the input value for the power series.</paragraph>
<paragraph id="par_id3144344" role="paragraph" xml-lang="en-US"><emph>N</emph> is the initial power</paragraph>
<paragraph id="par_id3144357" role="paragraph" xml-lang="en-US"><emph>M</emph> is the increment to increase N</paragraph>
<paragraph id="par_id3144370" role="paragraph" xml-lang="en-US"><emph>Coefficients</emph> is a series of coefficients. For each coefficient the series sum is extended by one section.</paragraph>
</section>

<section id="Section26">
<bookmark xml-lang="en-US" branch="index" id="bm_id3144386">
  <bookmark_value>PRODUCT function</bookmark_value>
  <bookmark_value>numbers;multiplying</bookmark_value>
  <bookmark_value>multiplying;numbers</bookmark_value>
</bookmark>
<comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PRODUKT" id="bm_id3144397" localize="false"/>

<h2 id="hd_id3144386">PRODUCT</h2>
<paragraph id="par_id3144414" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_PRODUKT">Multiplies all the numbers given as arguments and returns the product.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3144446" role="code" xml-lang="en-US">PRODUCT(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#number255"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3144494" role="paragraph" xml-lang="en-US"><item type="input">=PRODUCT(2;3;4)</item> returns 24.</paragraph><comment>see also FACT, SUM</comment>
</section>

<section id="Section25">
<bookmark xml-lang="en-US" branch="index" id="bm_id3160340">
  <bookmark_value>SUMSQ function</bookmark_value>
  <bookmark_value>square number additions</bookmark_value>
  <bookmark_value>sums;of square numbers</bookmark_value>
</bookmark>
<comment>mw added two entries</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUADRATESUMME" id="bm_id3160351" localize="false"/>

<h2 id="hd_id3160340">SUMSQ</h2>
<paragraph id="par_id3160368" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_QUADRATESUMME">Calculates the sum of the squares of a set of numbers.</ahelp></paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3160402" role="code" xml-lang="en-US">SUMSQ(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#number255"/>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3160449" role="paragraph" xml-lang="en-US">If you enter the numbers 2; 3 and 4 in the Number 1; 2 and 3 arguments, 29 is returned as the result.</paragraph>
</section>

<section id="Section24">
<bookmark xml-lang="en-US" branch="index" id="bm_id3158247">
  <bookmark_value>MOD function</bookmark_value>
  <bookmark_value>remainders of divisions</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_REST" id="bm_id3158259" localize="false"/>

<h2 id="hd_id3158247">MOD</h2>
<paragraph id="par_id3158276" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_REST">Returns the remainder when one integer is divided by another.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3158308" role="code" xml-lang="en-US">MOD(Dividend; Divisor)</paragraph>
<paragraph id="par_id3158321" role="paragraph" xml-lang="en-US">For integer arguments this function returns Dividend modulo Divisor, that is the remainder when <emph>Dividend</emph> is divided by <emph>Divisor</emph>.</paragraph>
<paragraph id="par_id3158341" role="paragraph" xml-lang="en-US">This function is implemented as <item type="literal">Dividend - Divisor * INT(Dividend/Divisor)</item> , and this formula gives the result if the arguments are not integer.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3158374" role="paragraph" xml-lang="en-US"><item type="input">=MOD(22;3)</item> returns 1, the remainder when 22 is divided by 3.</paragraph>
<paragraph id="par_id1278420" role="paragraph" xml-lang="en-US"><item type="input">=MOD(11.25;2.5)</item> returns 1.25.</paragraph><comment>see also QUOTIENT, INT</comment>
</section>

<section id="Section23">
<bookmark xml-lang="en-US" branch="index" id="bm_id3144592">
  <bookmark_value>QUOTIENT function</bookmark_value>
  <bookmark_value>divisions</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_QUOTIENT" id="bm_id3144603" localize="false"/>

<h2 id="hd_id3144592">QUOTIENT</h2>
<paragraph id="par_id3144627" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_QUOTIENT">Returns the integer part of a division operation.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3144659" role="code" xml-lang="en-US">QUOTIENT(Numerator; Denominator)</paragraph>
<paragraph id="par_id9038972" role="paragraph" xml-lang="en-US">Returns the integer part of <emph>Numerator</emph> divided by <emph>Denominator</emph>.</paragraph>
<paragraph id="par_id7985168" role="paragraph" xml-lang="en-US">QUOTIENT is equivalent to <item type="literal">INT(numerator/denominator)</item> for same-sign numerator and denominator, except that it may report errors with different error codes. More generally, it is equivalent to <item type="literal">INT(numerator/denominator/SIGN(numerator/denominator))*SIGN(numerator/denominator)</item>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3144687" role="paragraph" xml-lang="en-US"><item type="input">=QUOTIENT(11;3)</item> returns 3. The remainder of 2 is lost.</paragraph><comment>see also MOD, INT</comment>
</section>

<section id="Section22">
<bookmark xml-lang="en-US" branch="index" id="bm_id3144702">
  <bookmark_value>RADIANS function</bookmark_value>
  <bookmark_value>converting;degrees, into radians</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RAD" id="bm_id3158008" localize="false"/>

<h2 id="hd_id3144702">RADIANS</h2>
<paragraph id="par_id3158025" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RAD">Converts degrees to radians.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3158055" role="code" xml-lang="en-US">RADIANS(Number)</paragraph>
<paragraph id="par_id3158069" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the angle in degrees to be converted to radians.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3939634" role="paragraph" xml-lang="en-US"><item type="input">=RADIANS(90)</item> returns 1.5707963267949, which is PI/2 to Calc's accuracy.</paragraph><comment>see also DEGREES</comment>
</section>

<section id="Section67">
<embed href="text/scalc/01/func_rawsubtract.xhp#func_rawsubtract"/>
</section>

<section id="Section21">
<bookmark xml-lang="en-US" branch="index" id="bm_id3158121">
  <bookmark_value>ROUND function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RUNDEN" id="bm_id3158133" localize="false"/>

<h2 id="hd_id3158121">ROUND</h2>
<paragraph id="par_id3158150" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RUNDEN">Rounds a number to a certain number of decimal places.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3158182" role="code" xml-lang="en-US">ROUND(Number; Count)</paragraph>
<paragraph id="par_id3158196" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds to the nearest integer. If Count is negative, the function rounds to the nearest 10, 100, 1000, etc.</paragraph>
<paragraph id="par_id599688" role="paragraph" xml-lang="en-US">This function rounds to the nearest number. See ROUNDDOWN and ROUNDUP for alternatives.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3145876" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.348;2)</item> returns 2.35</paragraph>
<paragraph id="par_id3145899" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(-32.4834;3)</item> returns -32.483. Change the cell format to see all decimals.</paragraph>
<paragraph id="par_id1371501" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.348;0)</item> returns 2.</paragraph>
<paragraph id="par_id4661702" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.5)</item> returns 3.</paragraph>
<paragraph id="par_id7868892" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(987.65;-2)</item> returns 1000.</paragraph><comment>see also INT, TRUNC, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND</comment>
</section>

<section id="Section20">
<bookmark xml-lang="en-US" branch="index" id="bm_id3145991">
  <bookmark_value>ROUNDDOWN function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ABRUNDEN" id="bm_id3146003" localize="false"/>

<h2 id="hd_id3145991">ROUNDDOWN</h2>
<paragraph id="par_id3146020" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ABRUNDEN">Rounds a number down, toward zero, to a certain precision.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3146051" role="code" xml-lang="en-US">ROUNDDOWN(Number; Count)</paragraph>
<paragraph id="par_id3146064" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded down (towards zero) to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds down to an integer. If Count is negative, the function rounds down to the next 10, 100, 1000, etc.</paragraph>
<paragraph id="par_id2188787" role="paragraph" xml-lang="en-US">This function rounds towards zero. See ROUNDUP and ROUND for alternatives.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3163178" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDDOWN(1.234;2)</item> returns 1.23.</paragraph>
<paragraph id="par_id5833307" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDDOWN(45.67;0)</item> returns 45.</paragraph>
<paragraph id="par_id7726676" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDDOWN(-45.67)</item> returns -45.</paragraph>
<paragraph id="par_id3729361" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDDOWN(987.65;-2)</item> returns 900.</paragraph><comment>see also INT, TRUNC, ROUND, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND</comment>
</section>

<section id="Section19">
<bookmark xml-lang="en-US" branch="index" id="bm_id3163268">
  <bookmark_value>ROUNDUP function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_AUFRUNDEN" id="bm_id3163280" localize="false"/>

<h2 id="hd_id3163268">ROUNDUP</h2>
<paragraph id="par_id3163297" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_AUFRUNDEN">Rounds a number up, away from zero, to a certain precision.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3163328" role="code" xml-lang="en-US">ROUNDUP(Number; Count)</paragraph>
<paragraph id="par_id3163342" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded up (away from zero) to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds up to an integer. If Count is negative, the function rounds up to the next 10, 100, 1000, etc.</paragraph>
<paragraph id="par_id9573961" role="paragraph" xml-lang="en-US">This function rounds away from zero. See ROUNDDOWN and ROUND for alternatives.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3144786" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(1.1111;2)</item> returns 1.12.</paragraph>
<paragraph id="par_id7700430" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(1.2345;1)</item> returns 1.3.</paragraph>
<paragraph id="par_id1180455" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(45.67;0)</item> returns 46.</paragraph>
<paragraph id="par_id3405560" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(-45.67)</item> returns -46.</paragraph>
<paragraph id="par_id3409527" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(987.65;-2)</item> returns 1000.</paragraph><comment>see also INT, TRUNC, ROUND, ROUNDDOWN, CEILING, FLOOR, EVEN, ODD, MROUND</comment>
</section>

<section id="Section63">
<bookmark xml-lang="en-US" branch="index" id="bm_id5256537">
  <bookmark_value>SEC function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SECANT" id="bm_id6577644" localize="false"/>

<h2 id="hd_id5187204">SEC</h2>
<paragraph id="par_id9954962" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SECANT">Returns the secant of the given angle (in radians). The secant of an angle is equivalent to 1 divided by the cosine of that angle</ahelp></paragraph>
<embed href="text/scalc/00/avail_release.xhp#3.5"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id2055913" role="code" xml-lang="en-US">SEC(Number)</paragraph>
<paragraph id="par_id9568170" role="paragraph" xml-lang="en-US">Returns the (trigonometric) secant of <emph>Number</emph>, the angle in radians.</paragraph>
<paragraph id="par_id9047465" role="paragraph" xml-lang="en-US">To return the secant of an angle in degrees, use the RADIANS function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id6935513" role="paragraph" xml-lang="en-US"><item type="input">=SEC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the cosine of PI/4 radians.</paragraph>
<paragraph id="par_id3954287" role="paragraph" xml-lang="en-US"><item type="input">=SEC(RADIANS(60))</item> returns 2, the secant of 60 degrees.</paragraph><comment>see also SIN, TAN, COT, CSC, ACOS, ASIN, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section65">
<bookmark xml-lang="en-US" branch="index" id="bm_id840005">
  <bookmark_value>SECH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SECANTHYP" id="bm_id6301347" localize="false"/>

<h2 id="hd_id8661934">SECH</h2>
<paragraph id="par_id408174" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SECANTHYP">Returns the hyperbolic secant of a number.</ahelp></paragraph>
<embed href="text/scalc/00/avail_release.xhp#3.5"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id4985391" role="code" xml-lang="en-US">SECH(Number)</paragraph>
<paragraph id="par_id1952124" role="paragraph" xml-lang="en-US">Returns the hyperbolic secant of <emph>Number</emph>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id1187764" role="paragraph" xml-lang="en-US"><item type="input">=SECH(0)</item> returns 1, the hyperbolic secant of 0.</paragraph><comment>see also SINH, TANH, COTH, CSCH, ACOSH, ASINH, ATANH, ACOTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section18">
<bookmark xml-lang="en-US" branch="index" id="bm_id3144877">
  <bookmark_value>SIN function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SIN" id="bm_id3144889" localize="false"/>

<h2 id="hd_id3144877">SIN</h2>
<paragraph id="par_id3144906" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SIN">Returns the sine of the given angle (in radians).</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3144937" role="code" xml-lang="en-US">SIN(Number)</paragraph>
<paragraph id="par_id3144950" role="paragraph" xml-lang="en-US">Returns the (trigonometric) sine of <emph>Number</emph>, the angle in radians.</paragraph>
<paragraph id="par_id8079470" role="paragraph" xml-lang="en-US">To return the sine of an angle in degrees, use the RADIANS function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3144983" role="paragraph" xml-lang="en-US"><item type="input">=SIN(PI()/2)</item> returns 1, the sine of PI/2 radians.</paragraph>
<paragraph id="par_id3916440" role="paragraph" xml-lang="en-US"><item type="input">=SIN(RADIANS(30))</item> returns 0.5, the sine of 30 degrees.</paragraph><comment>see also COS, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section17">
<bookmark xml-lang="en-US" branch="index" id="bm_id3163397">
  <bookmark_value>SINH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SINHYP" id="bm_id3163409" localize="false"/>

<h2 id="hd_id3163397">SINH</h2>
<paragraph id="par_id3163426" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SINHYP">Returns the hyperbolic sine of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3163457" role="code" xml-lang="en-US">SINH(Number)</paragraph>
<paragraph id="par_id3163471" role="paragraph" xml-lang="en-US">Returns the hyperbolic sine of <emph>Number</emph>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3163504" role="paragraph" xml-lang="en-US"><item type="input">=SINH(0)</item> returns 0, the hyperbolic sine of 0.</paragraph><comment>see also COSH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section16">
<bookmark xml-lang="en-US" branch="index" id="bm_id3163596">
  <bookmark_value>SUM function</bookmark_value>
  <bookmark_value>adding;numbers in cell ranges</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMME" id="bm_id3163608" localize="false"/>

<h2 id="hd_id3163596"><variable id="sum_head"><link href="text/scalc/01/04060106.xhp#Section16">SUM</link></variable></h2>
<paragraph id="par_id3163625" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMME">Adds a set of numbers.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3163656" role="code" xml-lang="en-US">SUM(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph>
<embed href="text/scalc/01/ful_func.xhp#number255"/>
<tip id="par_id151567608802604">SUM ignores any text or empty cell within a range or array. If you suspect wrong results of the SUM function, look for text in the data ranges. Use the <link href="text/scalc/01/03080000.xhp" name="value highlight">value highlighting</link> feature to highlight the text contents in the range that may represent a number.</tip>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3163704" role="paragraph" xml-lang="en-US">If you enter the numbers <item type="input">2</item>; <item type="input">3 </item>and <item type="input">4</item> in the Number 1; 2 and 3 text boxes, 9 will be returned as the result.</paragraph>
<paragraph id="par_id3151740" role="paragraph" xml-lang="en-US"><item type="input">=SUM(A1;A3;B5)</item> calculates the sum of the three cells. <item type="input">=SUM (A1:E10)</item> calculates the sum of all cells in the A1 to E10 cell range.</paragraph>
<paragraph id="par_id3151756" role="paragraph" xml-lang="en-US">Conditions linked by AND can be used with the function SUM() in the following manner:</paragraph>
<paragraph id="par_id3151774" role="paragraph" xml-lang="en-US">Example assumption: You have entered invoices into a table. Column A contains the date value of the invoice, column B the amounts. You want to find a formula that you can use to return the total of all amounts only for a specific month, e.g. only the amount for the period &gt;=2008-01-01 to &lt;2008-02-01. The range with the date values covers A1:A40, the range containing the amounts to be totaled is B1:B40. C1 contains the start date, 2008<item type="input">-01-01</item>, of the invoices to be included and C2 the date, 2008<item type="input">-02-01</item>, that is no longer included.</paragraph>
<paragraph id="par_id3151799" role="paragraph" xml-lang="en-US">Enter the following formula as an array formula:</paragraph>
<paragraph id="par_id3151813" role="paragraph" xml-lang="en-US"><item type="input">=SUM((A1:A40&gt;=C1)*(A1:A40&lt;C2)*B1:B40)</item></paragraph>
<paragraph id="par_id3151828" role="paragraph" xml-lang="en-US">In order to enter this as an array formula, you must press the Shift<switchinline select="sys"><caseinline select="MAC">+Command
</caseinline><defaultinline>+ Ctrl</defaultinline></switchinline>+ Enter keys instead of simply pressing the Enter key to close the formula. The formula will then be shown in the <emph>Formula</emph> bar enclosed in braces.</paragraph>
<paragraph id="par_id3151869" role="paragraph" xml-lang="en-US">{=SUM((A1:A40&gt;=C1)*(A1:A40&lt;C2)*B1:B40)}</paragraph>
<paragraph id="par_id3151884" role="paragraph" xml-lang="en-US">The formula is based on the fact that the result of a comparison is 1 if the criterion is met and 0 if it is not met. The individual comparison results will be treated as an array and used in matrix multiplication, and at the end the individual values will be totaled to give the result matrix.</paragraph>
</section>

<section id="Section15">
<bookmark xml-lang="en-US" branch="index" id="bm_id3151957">
  <bookmark_value>SUMIF function</bookmark_value>
  <bookmark_value>adding;specified numbers</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEWENN" id="bm_id3151969" localize="false"/>

<h2 id="hd_id3151957"><variable id="sumif_head"><link href="text/scalc/01/04060106.xhp#Section15">SUMIF</link></variable></h2>
<paragraph id="par_id3151986" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEWENN">Adds the cells specified by a given criteria.</ahelp> This function is used to browse a range when you search for a certain value.</paragraph>
<embed href="text/shared/00/00000001.xhp#regulaer"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3152028" role="code" xml-lang="en-US">SUMIF(Range; Criteria; SumRange)</paragraph>
<paragraph id="par_id3152043" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range to which the criteria are to be applied.</paragraph>
<paragraph id="par_id3152062" role="paragraph" xml-lang="en-US"><emph>Criteria</emph> is the cell in which the search criterion is shown, or the search criterion itself. If the criteria is written into the formula, it has to be surrounded by double quotes.</paragraph>
<paragraph id="par_id3152083" role="paragraph" xml-lang="en-US"><emph>SumRange</emph> is the range from which values are summed. If this parameter has not been indicated, the values found in the Range are summed.</paragraph>
<note id="par_id8347422">SUMIF supports the reference concatenation operator (~) only in the Criteria parameter, and only if the optional SumRange parameter is not given.</note>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3152148" role="paragraph" xml-lang="en-US">To sum up only negative numbers: <item type="input">=SUMIF(A1:A10;"&lt;0")</item></paragraph>
<paragraph id="par_id6670125" role="paragraph" xml-lang="en-US"><item type="input">=SUMIF(A1:A10;"&gt;0";B1:B10)</item> - sums values from the range B1:B10 only if the corresponding values in the range A1:A10 are &gt;0.</paragraph>
<paragraph id="par_id6062196" role="paragraph" xml-lang="en-US">See COUNTIF() for some more syntax examples that can be used with SUMIF().</paragraph>
</section>

<section id="color">
<embed href="text/scalc/01/func_color.xhp#func_color"/>
</section>

<section id="sumifs">

<h2 localize="false" id="hd_id72921259523046"><embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/></h2>
<paragraph id="par_id131512822630259" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_des"/></paragraph>
</section>

<section id="Section14">
<bookmark xml-lang="en-US" branch="index" id="bm_id3152195">
  <bookmark_value>TAN function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAN" id="bm_id3152207" localize="false"/>

<h2 id="hd_id3152195">TAN</h2>
<paragraph id="par_id3152224" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TAN">Returns the tangent of the given angle (in radians).</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3152255" role="code" xml-lang="en-US">TAN(Number)</paragraph>
<paragraph id="par_id3152269" role="paragraph" xml-lang="en-US">Returns the (trigonometric) tangent of <emph>Number</emph>, the angle in radians.</paragraph>
<paragraph id="par_id5752128" role="paragraph" xml-lang="en-US">To return the tangent of an angle in degrees, use the RADIANS function.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3152301" role="paragraph" xml-lang="en-US"><item type="input">=TAN(PI()/4) </item>returns 1, the tangent of PI/4 radians.</paragraph>
<paragraph id="par_id1804864" role="paragraph" xml-lang="en-US"><item type="input">=TAN(RADIANS(45))</item> returns 1, the tangent of 45 degrees.</paragraph><comment>see also COS, SIN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section13">
<bookmark xml-lang="en-US" branch="index" id="bm_id3165434">
  <bookmark_value>TANH function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TANHYP" id="bm_id3165446" localize="false"/>

<h2 id="hd_id3165434">TANH</h2>
<paragraph id="par_id3165462" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TANHYP">Returns the hyperbolic tangent of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3165494" role="code" xml-lang="en-US">TANH(Number)</paragraph>
<paragraph id="par_id3165508" role="paragraph" xml-lang="en-US">Returns the hyperbolic tangent of <emph>Number</emph>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3165541" role="paragraph" xml-lang="en-US"><item type="input">=TANH(0)</item> returns 0, the hyperbolic tangent of 0.</paragraph><comment>see also COSH, SINH, COTH, ACOSH, ASINH, ATANH, ACOTH</comment>
<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/>
</section>

<section id="Section12">
<bookmark xml-lang="en-US" branch="index" id="bm_id3165633">
  <bookmark_value>AutoFilter function; subtotals</bookmark_value>
  <bookmark_value>sums;of filtered data</bookmark_value>
  <bookmark_value>filtered data; sums</bookmark_value>
  <bookmark_value>SUBTOTAL function</bookmark_value>
</bookmark>
<comment>mw made "sums..." a two level entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEILERGEBNIS" id="bm_id3165644" localize="false"/>

<h2 id="hd_id3165633">SUBTOTAL</h2>
<paragraph id="par_id3165682" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TEILERGEBNIS">Calculates subtotals.</ahelp> If a range already contains subtotals, these are not used for further calculations. Use this function with the AutoFilters to take only the filtered records into account.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3165717" role="code" xml-lang="en-US">SUBTOTAL(Function; Range)</paragraph>
<paragraph id="par_id3165731" role="paragraph" xml-lang="en-US"><emph>Function</emph> is a number that stands for one of the following functions:</paragraph>

<table id="tbl_id3165752">
  <tablerow>
    <tablecell>
      <paragraph id="par_id3165782" role="tablehead" xml-lang="en-US">Function index</paragraph>
      <paragraph id="par_id20082017081856189" role="tablehead" xml-lang="en-US">(includes hidden values)</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716337755" role="tablehead" xml-lang="en-US">Function index</paragraph>
      <paragraph id="par_id200820170818568679" role="tablehead" xml-lang="en-US">(ignores hidden values)</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3165806" role="tablehead" xml-lang="en-US">Function</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3165833" role="paragraph" localize="false" xml-lang="en-US">1</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id20082017071634481" role="paragraph" localize="false" xml-lang="en-US">101</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3165856" role="paragraph" xml-lang="en-US">AVERAGE</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3165883" role="paragraph" localize="false" xml-lang="en-US">2</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716349348" role="paragraph" localize="false" xml-lang="en-US">102</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3165906" role="paragraph" xml-lang="en-US">COUNT</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3165933" role="paragraph" localize="false" xml-lang="en-US">3</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716342109" role="paragraph" localize="false" xml-lang="en-US">103</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3165956" role="paragraph" xml-lang="en-US">COUNTA</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3165983" role="paragraph" localize="false" xml-lang="en-US">4</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716348854" role="paragraph" localize="false" xml-lang="en-US">104</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3166006" role="paragraph" xml-lang="en-US">MAX</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3166033" role="paragraph" localize="false" xml-lang="en-US">5</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id20082017071634799" role="paragraph" localize="false" xml-lang="en-US">105</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3166056" role="paragraph" xml-lang="en-US">MIN</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3143316" role="paragraph" localize="false" xml-lang="en-US">6</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716342762" role="paragraph" localize="false" xml-lang="en-US">106</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3143339" role="paragraph" xml-lang="en-US">PRODUCT</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3143366" role="paragraph" localize="false" xml-lang="en-US">7</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716348779" role="paragraph" localize="false" xml-lang="en-US">107</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3143389" role="paragraph" xml-lang="en-US">STDEV</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3143416" role="paragraph" localize="false" xml-lang="en-US">8</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716355943" role="paragraph" localize="false" xml-lang="en-US">108</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3143439" role="paragraph" xml-lang="en-US">STDEVP</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3143466" role="paragraph" localize="false" xml-lang="en-US">9</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716355993" role="paragraph" localize="false" xml-lang="en-US">109</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3143489" role="paragraph" xml-lang="en-US">SUM</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3143516" role="paragraph" localize="false" xml-lang="en-US">10</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716351843" role="paragraph" localize="false" xml-lang="en-US">110</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3143539" role="paragraph" xml-lang="en-US">VAR</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id3143566" role="paragraph" localize="false" xml-lang="en-US">11</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170716353789" role="paragraph" localize="false" xml-lang="en-US">111</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id3143589" role="paragraph" xml-lang="en-US">VARP</paragraph>
    </tablecell>
  </tablerow>
</table>

<paragraph id="par_id20082017075115609" role="paragraph" xml-lang="en-US">Use numbers 1-11 to include manually hidden rows or 101-111 to exclude them; filtered-out cells are always excluded.</paragraph>
<paragraph id="par_id3143606" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range whose cells are included.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3143638" role="paragraph" xml-lang="en-US">You have a table in the cell range A1:B6 containing a bill of material for 10 students. Row 2 (Pen) is manually hidden. You want to see the sum of the figures that are displayed; that is, just the subtotal for the filtered rows. In this case the correct formula would be:</paragraph>

<table id="tbl_200820170737188127">
  <tablerow>
    <tablecell>
      <paragraph id="par_id200820170806057438" role="tablehead" localize="false" xml-lang="en-US"/>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751186827" role="tablehead" localize="false" xml-lang="en-US">A</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751186410" role="tablehead" localize="false" xml-lang="en-US">B</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id200820170751189874" role="tablehead" localize="false" xml-lang="en-US">1</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751186696" role="tablecontent" xml-lang="en-US"><emph>ITEM</emph></paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id20082017075118422" role="tablecontent" xml-lang="en-US"><emph>QUANTITY</emph></paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id200820170751187332" role="tablehead" localize="false" xml-lang="en-US">2</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751195726" role="tablecontent" xml-lang="en-US">Pen</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751199921" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id200820170751197796" role="tablehead" localize="false" xml-lang="en-US">3</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751195912" role="tablecontent" xml-lang="en-US">Pencil</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751195191" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id200820170751193908" role="tablehead" localize="false" xml-lang="en-US">4</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751199399" role="tablecontent" xml-lang="en-US">Notebook</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751204129" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id200820170751201815" role="tablehead" localize="false" xml-lang="en-US">5</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751201323" role="tablecontent" xml-lang="en-US">Rubber</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id20082017075120380" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph>
    </tablecell>
  </tablerow>
  <tablerow>
    <tablecell>
      <paragraph id="par_id20082017075120914" role="tablehead" localize="false" xml-lang="en-US">6</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751204884" role="tablecontent" xml-lang="en-US">Sharpener</paragraph>
    </tablecell>
    <tablecell>
      <paragraph id="par_id200820170751204938" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph>
    </tablecell>
  </tablerow>
</table>

<paragraph id="par_id3143658" role="paragraph" xml-lang="en-US"><item type="input">=SUBTOTAL(9;B2:B6) returns 50.</item></paragraph>
<paragraph id="par_id200820170751218092" role="paragraph" xml-lang="en-US"><item type="input">=SUBTOTAL(109;B2:B6) returns 40.</item></paragraph>
</section>

<section id="Section11">
<bookmark xml-lang="en-US" branch="index" id="bm_id3143672">
  <bookmark_value>Euro; converting</bookmark_value>
  <bookmark_value>EUROCONVERT function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UMRECHNEN" id="bm_id3143684" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EUROCONVERT" id="bm_id0119200904282677" localize="false"/>

<h2 id="hd_id3143672">EUROCONVERT<comment>insert link in financial</comment></h2>
<paragraph id="par_id3143708" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_UMRECHNEN">Converts between old European national currency and to and from Euros.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3143748" role="code" xml-lang="en-US">EUROCONVERT(Value; "From_currency"; "To_currency", full_precision, triangulation_precision)</paragraph>
<paragraph id="par_id3143763" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the amount of the currency to be converted.</paragraph>
<paragraph id="par_id3143782" role="paragraph" xml-lang="en-US"><emph>From_currency</emph> and <emph>To_currency</emph> are the currency units to convert from and to respectively. These must be text, the official abbreviation for the currency (for example, "EUR"). The rates (shown per Euro) were set by the European Commission.</paragraph>
<paragraph id="par_id0119200904301810" role="paragraph" xml-lang="en-US"><emph>Full_precision</emph> is optional. If omitted or False, the result is rounded according to the decimals of the To currency. If Full_precision is True, the result is not rounded.</paragraph>
<paragraph id="par_id0119200904301815" role="paragraph" xml-lang="en-US"><emph>Triangulation_precision</emph> is optional. If Triangulation_precision is given and &gt;=3, the intermediate result of a triangular conversion (currency1,EUR,currency2) is rounded to that precision. If Triangulation_precision is omitted, the intermediate result is not rounded. Also if To currency is "EUR", Triangulation_precision is used as if triangulation was needed and conversion from EUR to EUR was applied.</paragraph>

<h3 id="par_id3143819"><emph>Examples</emph></h3>
<paragraph id="par_id3143837" role="paragraph" xml-lang="en-US"><item type="input">=EUROCONVERT(100;"ATS";"EUR")</item> converts 100 Austrian Schillings into Euros.</paragraph>
<paragraph id="par_id3143853" role="paragraph" xml-lang="en-US"><item type="input">=EUROCONVERT(100;"EUR";"DEM")</item> converts 100 Euros into German Marks.</paragraph>
</section>

<section id="convert">
<bookmark xml-lang="en-US" branch="index" id="bm_id0908200902090676">
  <bookmark_value>CONVERT_OOO function</bookmark_value>
</bookmark>

<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UMRECHNEN" id="bm_id0908200902093111" localize="false"/>

<h2 id="hd_id0908200902074836">CONVERT_OOO</h2>
<paragraph id="par_id0908200902131122" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts a value from one unit of measurement to another unit of measurement. The conversion factors are given in a list in the configuration.</ahelp></paragraph>
<paragraph id="par_id0908200902475420" role="paragraph" xml-lang="en-US">At one time the list of conversion factors included the legacy European currencies and the Euro (see examples below). We suggest using the new function EUROCONVERT for converting these currencies.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id0908200902131191" role="code" xml-lang="en-US">CONVERT_OOO(value;"text";"text")</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id090820090213112" role="paragraph" xml-lang="en-US"><item type="input">=CONVERT_OOO(100;"ATS";"EUR")</item> returns the Euro value of 100 Austrian Schillings.</paragraph>
<paragraph id="par_id0908200902475431" role="paragraph" xml-lang="en-US">=CONVERT_OOO(100;"EUR";"DEM") converts 100 Euros into German Marks.</paragraph>
</section>

<section id="Section10">
<bookmark xml-lang="en-US" branch="index" id="bm_id3157177">
  <bookmark_value>ODD function</bookmark_value>
  <bookmark_value>rounding;up/down to nearest odd integer</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNGERADE" id="bm_id3157188" localize="false"/>

<h2 id="hd_id3157177">ODD</h2>
<paragraph id="par_id3157205" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_UNGERADE">Rounds a positive number up to the nearest odd integer and a negative number down to the nearest odd integer.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3157237" role="code" xml-lang="en-US">ODD(Number)</paragraph>
<paragraph id="par_id3157250" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the next odd integer up, away from zero.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3157283" role="paragraph" xml-lang="en-US"><item type="input">=ODD(1.2)</item> returns 3.</paragraph>
<paragraph id="par_id8746910" role="paragraph" xml-lang="en-US"><item type="input">=ODD(1)</item> returns 1.</paragraph>
<paragraph id="par_id9636524" role="paragraph" xml-lang="en-US"><item type="input">=ODD(0)</item> returns 1.</paragraph>
<paragraph id="par_id5675527" role="paragraph" xml-lang="en-US"><item type="input">=ODD(-3.1)</item> returns -5.</paragraph><comment>see also CEILING, FLOOR, EVEN, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment>
</section>

<section id="Section8">
<bookmark xml-lang="en-US" branch="index" id="bm_id3164086">
  <bookmark_value>SIGN function</bookmark_value>
  <bookmark_value>algebraic signs</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VORZEICHEN" id="bm_id3164098" localize="false"/>

<h2 id="hd_id3164086">SIGN</h2>
<paragraph id="par_id3164115" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VORZEICHEN">Returns the sign of a number. Returns 1 if the number is positive, -1 if negative and 0 if zero.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3164150" role="code" xml-lang="en-US">SIGN(Number)</paragraph>
<paragraph id="par_id3164164" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number whose sign is to be determined.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3164197" role="paragraph" xml-lang="en-US"><item type="input">=SIGN(3.4)</item> returns 1.</paragraph>
<paragraph id="par_id3164212" role="paragraph" xml-lang="en-US"><item type="input">=SIGN(-4.5)</item> returns -1.</paragraph><comment>see also ABS</comment>
</section>

<section id="Section7">
<bookmark xml-lang="en-US" branch="index" id="bm_id3164252">
  <bookmark_value>MROUND function</bookmark_value>
  <bookmark_value>nearest multiple</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MROUND" id="bm_id3164264" localize="false"/>

<h2 id="hd_id3164252">MROUND</h2>
<paragraph id="par_id3164288" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MROUND">Returns a number rounded to the nearest multiple of another number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3164320" role="code" xml-lang="en-US">MROUND(Number; Multiple)</paragraph>
<paragraph id="par_id3486434" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the nearest multiple of <emph>Multiple</emph>.</paragraph>
<paragraph id="par_id3068636" role="paragraph" xml-lang="en-US">An alternative implementation would be <item type="literal">Multiple * ROUND(Number/Multiple)</item>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3164347" role="paragraph" xml-lang="en-US"><item type="input">=MROUND(15.5;3)</item> returns 15, as 15.5 is closer to 15 (= 3*5) than to 18 (= 3*6).</paragraph>
<paragraph id="par_idN14DD6" role="paragraph" xml-lang="en-US"><item type="input">=MROUND(1.4;0.5)</item> returns 1.5 (= 0.5*3).</paragraph><comment>see also CEILING, FLOOR, EVEN, ODD, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment>
</section>

<section id="Section6">
<bookmark xml-lang="en-US" branch="index" id="bm_id3164375">
  <bookmark_value>SQRT function</bookmark_value>
  <bookmark_value>square roots;positive numbers</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WURZEL" id="bm_id3164387" localize="false"/>

<h2 id="hd_id3164375">SQRT</h2>
<paragraph id="par_id3164404" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WURZEL">Returns the positive square root of a number.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3164437" role="code" xml-lang="en-US">SQRT(Number)</paragraph>
<paragraph id="par_id3164451" role="paragraph" xml-lang="en-US">Returns the positive square root of <emph>Number</emph>.</paragraph>
<paragraph id="par_id6870021" role="paragraph" xml-lang="en-US">Number must be positive.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3164484" role="paragraph" xml-lang="en-US"><item type="input">=SQRT(16)</item> returns 4.</paragraph>
<paragraph id="par_id3591723" role="paragraph" xml-lang="en-US"><item type="input">=SQRT(-16)</item> returns an <item type="literal">invalid argument</item> error.</paragraph><comment>see also SQRTPI, POWER</comment>
</section>

<section id="Section5">
<bookmark xml-lang="en-US" branch="index" id="bm_id3164560">
  <bookmark_value>SQRTPI function</bookmark_value>
  <bookmark_value>square roots;products of Pi</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_SQRTPI" id="bm_id3164572" localize="false"/>

<h2 id="hd_id3164560">SQRTPI</h2>
<paragraph id="par_id3164596" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_SQRTPI">Returns the square root of (PI times a number).</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3164627" role="code" xml-lang="en-US">SQRTPI(Number)</paragraph>
<paragraph id="par_id1501510" role="paragraph" xml-lang="en-US">Returns the positive square root of (PI multiplied by <emph>Number</emph>).</paragraph>
<paragraph id="par_id9929197" role="paragraph" xml-lang="en-US">This is equivalent to <item type="literal">SQRT(PI()*Number)</item>.</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3164654" role="paragraph" xml-lang="en-US"><item type="input">=SQRTPI(2)</item> returns the squareroot of (2PI), approximately 2.506628.</paragraph><comment>see also SQRT</comment>
</section>

<section id="Section4">
<bookmark xml-lang="en-US" branch="index" id="bm_id3164669">
<bookmark_value>random numbers; between limits</bookmark_value>
<bookmark_value>RANDBETWEEN function</bookmark_value>
</bookmark>
<comment>mw changed "random numbers;"</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_RANDBETWEEN" id="bm_id3164680" localize="false"/>

<h2 id="hd_id3164669">RANDBETWEEN</h2>
<paragraph id="par_id3164711" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_RANDBETWEEN">Returns an integer random number in a specified range.</ahelp></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3164758" role="code" xml-lang="en-US">RANDBETWEEN(Bottom; Top)</paragraph>
<paragraph id="par_id7112338" role="paragraph" xml-lang="en-US">Returns an integer random number between integers <emph>Bottom</emph> and <emph>Top</emph> (both inclusive).</paragraph>
<paragraph id="par_id2855616" role="paragraph" xml-lang="en-US">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9.</paragraph>
<paragraph id="par_id2091433" role="paragraph" xml-lang="en-US">To generate random numbers which never recalculate, copy cells containing this function, and use <item type="menuitem">Edit - Paste Special</item> (with <item type="menuitem">Paste All</item> and <item type="menuitem">Formulas</item> not marked and <item type="menuitem">Numbers</item> marked).</paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id3164785" role="paragraph" xml-lang="en-US"><item type="input">=RANDBETWEEN(20;30)</item> returns an integer of between 20 and 30.</paragraph><comment>see also RAND</comment>

<bookmark xml-lang="en-US" branch="index" id="bm_id461590241346526">
<bookmark_value>random numbers non-volatile; between limits</bookmark_value>
<bookmark_value>RANDBETWEEN.NV function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RANDBETWEEN_NV" id="bm_id601590240409484" localize="false"/>
<h2 id="hd_id171590240366277">RANDBETWEEN.NV</h2>
<paragraph role="paragraph" id="par_id391590240473510"><ahelp hid="HID_FUNC_RANDBETWEEN_NV">Returns an non-volatile integer random number in a specified range.</ahelp></paragraph>
<embed href="text/scalc/00/avail_release.xhp#7.0"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id181590240522012">RANDBETWEEN.NV(Bottom; Top)</paragraph>
<paragraph role="paragraph" id="par_id91590242400917">Returns an non-volatile integer random number between integers <emph>Bottom</emph> and <emph>Top</emph> (both inclusive). A non-volatile function is not recalculated at new input events or pressing <keycode>F9</keycode>. However, the function is recalculated when pressing <keycode>F9</keycode> with the cursor on the cell containing the function, when opening the file, and when <emph>Top</emph> or <emph>Bottom</emph> are recalculated.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id151590240999839"><input>=RANDBETWEEN.NV(20;30)</input> returns a non-volatile integer between 20 and 30.</paragraph>
<paragraph role="paragraph" id="par_id1001590241005601"><input>=RANDBETWEEN.NV(A1;30)</input> returns a non-volatile integer between the value of cell A1 and 30. The function is recalculated when the contents of cell A1 change.</paragraph>
</section>

<section id="Section3">
<bookmark xml-lang="en-US" branch="index" id="bm_id3164800">
<bookmark_value>RAND function</bookmark_value>
<bookmark_value>random numbers;between 0 and 1</bookmark_value>
</bookmark>
<comment>mw added one entry</comment>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZUFALLSZAHL" id="bm_id3164812" localize="false"/>

<h2 id="hd_id3164800">RAND</h2>
<paragraph id="par_id3164829" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZUFALLSZAHL">Returns a random number between 0 and 1.</ahelp><comment>The value of 0 can be returned, the value of 1 not.</comment><comment>this is really true after issue 53642 will be fixed</comment></paragraph>

<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph id="par_id3164884" role="code" xml-lang="en-US">RAND()</paragraph>
<paragraph id="par_id5092318" role="paragraph" xml-lang="en-US">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9.</paragraph>
<paragraph id="par_id9312417" role="paragraph" xml-lang="en-US">To generate random numbers which never recalculate, either:</paragraph>
<list type="unordered">
<listitem>
    <paragraph id="par_id451590242105253"  role="listitem">Copy cells each containing =RAND(), and use <menuitem>Edit - Paste Special</menuitem> (with <emph>Paste All</emph> and <emph>Formulas</emph> not marked and <emph>Numbers</emph> marked).</paragraph>
</listitem>
<listitem>
    <paragraph id="par_id801590242114296"  role="listitem">Use the Fill Cell command with random numbers (<menuitem>Sheet - Fill Cells - Fill Random Numbers</menuitem>).</paragraph>
</listitem>
<listitem>
    <paragraph id="par_id41590242118383"  role="listitem">Use the RAND.NV() function for non-volatile random numbers.</paragraph>
    </listitem>
</list>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph id="par_id9569078" role="paragraph" xml-lang="en-US"><item type="input">=RAND()</item> returns a random number between 0 and 1.</paragraph><comment>see also RANDBETWEEN</comment>

<bookmark xml-lang="en-US" branch="index" id="bm_id341590241488944">
<bookmark_value>random numbers non-volatile;between 0 and 1</bookmark_value>
<bookmark_value>RAND.NV function</bookmark_value>
</bookmark>
<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RAND_NV" id="bm_id111590240232198" localize="false"/>
<h2 id="hd_id71590238179170">RAND.NV</h2>
<paragraph role="paragraph" id="par_id101590238875834"><ahelp hid="HID_FUNC_RAND_NV">Returns a non-volatile random number between 0 and 1.</ahelp></paragraph>
<embed href="text/scalc/00/avail_release.xhp#7.0"/>
<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
<paragraph role="code" id="par_id391590238945182">RAND.NV()</paragraph>
<paragraph role="paragraph" id="par_id271590239748534">This function produces a non-volatile random number on input. A non-volatile function is not recalculated at new input events. The function does not recalculate when pressing <keycode>F9</keycode>, except when the cursor is on the cell containing the function. The function is recalculated when opening the file.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectionexample"/>
<paragraph role="paragraph" id="par_id191590241215013"><input>=RAND.NV()</input> returns a non-volatile random number between 0 and 1.</paragraph>
</section>
</sort>

<section id="relatedtopics">
<embed href="text/scalc/01/04060100.xhp#drking"/>
</section>
</body>

</helpdocument>