From ed5640d8b587fbcfed7dd7967f3de04b37a76f26 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 11:06:44 +0200 Subject: Adding upstream version 4:7.4.7. Signed-off-by: Daniel Baumann --- helpcontent2/source/text/scalc/01/01120000.xhp | 49 + helpcontent2/source/text/scalc/01/02110000.xhp | 167 ++ helpcontent2/source/text/scalc/01/02120000.xhp | 40 + helpcontent2/source/text/scalc/01/02120100.xhp | 164 ++ helpcontent2/source/text/scalc/01/02140000.xhp | 66 + helpcontent2/source/text/scalc/01/02140100.xhp | 45 + helpcontent2/source/text/scalc/01/02140200.xhp | 45 + helpcontent2/source/text/scalc/01/02140300.xhp | 45 + helpcontent2/source/text/scalc/01/02140400.xhp | 45 + helpcontent2/source/text/scalc/01/02140500.xhp | 53 + helpcontent2/source/text/scalc/01/02140600.xhp | 115 ++ helpcontent2/source/text/scalc/01/02140700.xhp | 194 +++ helpcontent2/source/text/scalc/01/02150000.xhp | 70 + helpcontent2/source/text/scalc/01/02160000.xhp | 82 + helpcontent2/source/text/scalc/01/02170000.xhp | 50 + helpcontent2/source/text/scalc/01/02180000.xhp | 58 + helpcontent2/source/text/scalc/01/02190000.xhp | 44 + helpcontent2/source/text/scalc/01/02190100.xhp | 47 + helpcontent2/source/text/scalc/01/02190200.xhp | 56 + helpcontent2/source/text/scalc/01/02200000.xhp | 39 + helpcontent2/source/text/scalc/01/02210000.xhp | 42 + helpcontent2/source/text/scalc/01/02220000.xhp | 38 + helpcontent2/source/text/scalc/01/03070000.xhp | 58 + helpcontent2/source/text/scalc/01/03080000.xhp | 55 + helpcontent2/source/text/scalc/01/03090000.xhp | 50 + helpcontent2/source/text/scalc/01/03100000.xhp | 53 + helpcontent2/source/text/scalc/01/04010000.xhp | 49 + helpcontent2/source/text/scalc/01/04010100.xhp | 48 + helpcontent2/source/text/scalc/01/04010200.xhp | 48 + helpcontent2/source/text/scalc/01/04020000.xhp | 68 + helpcontent2/source/text/scalc/01/04030000.xhp | 58 + helpcontent2/source/text/scalc/01/04040000.xhp | 58 + helpcontent2/source/text/scalc/01/04050000.xhp | 74 + helpcontent2/source/text/scalc/01/04050100.xhp | 49 + helpcontent2/source/text/scalc/01/04060000.xhp | 110 ++ helpcontent2/source/text/scalc/01/04060100.xhp | 60 + helpcontent2/source/text/scalc/01/04060101.xhp | 1022 ++++++++++++ helpcontent2/source/text/scalc/01/04060102.xhp | 139 ++ helpcontent2/source/text/scalc/01/04060103.xhp | 737 +++++++++ helpcontent2/source/text/scalc/01/04060104.xhp | 742 +++++++++ helpcontent2/source/text/scalc/01/04060105.xhp | 202 +++ helpcontent2/source/text/scalc/01/04060106.xhp | 1554 +++++++++++++++++ helpcontent2/source/text/scalc/01/04060107.xhp | 1162 +++++++++++++ helpcontent2/source/text/scalc/01/04060108.xhp | 153 ++ helpcontent2/source/text/scalc/01/04060109.xhp | 700 ++++++++ helpcontent2/source/text/scalc/01/04060110.xhp | 759 +++++++++ helpcontent2/source/text/scalc/01/04060111.xhp | 204 +++ helpcontent2/source/text/scalc/01/04060112.xhp | 682 ++++++++ helpcontent2/source/text/scalc/01/04060115.xhp | 428 +++++ helpcontent2/source/text/scalc/01/04060116.xhp | 428 +++++ helpcontent2/source/text/scalc/01/04060118.xhp | 606 +++++++ helpcontent2/source/text/scalc/01/04060119.xhp | 611 +++++++ helpcontent2/source/text/scalc/01/04060120.xhp | 129 ++ helpcontent2/source/text/scalc/01/04060181.xhp | 714 ++++++++ helpcontent2/source/text/scalc/01/04060182.xhp | 496 ++++++ helpcontent2/source/text/scalc/01/04060183.xhp | 326 ++++ helpcontent2/source/text/scalc/01/04060184.xhp | 561 +++++++ helpcontent2/source/text/scalc/01/04060185.xhp | 786 +++++++++ helpcontent2/source/text/scalc/01/04060199.xhp | 297 ++++ helpcontent2/source/text/scalc/01/04070000.xhp | 47 + helpcontent2/source/text/scalc/01/04070100.xhp | 87 + helpcontent2/source/text/scalc/01/04070200.xhp | 59 + helpcontent2/source/text/scalc/01/04070300.xhp | 61 + helpcontent2/source/text/scalc/01/04070400.xhp | 69 + helpcontent2/source/text/scalc/01/04080000.xhp | 71 + helpcontent2/source/text/scalc/01/04090000.xhp | 58 + helpcontent2/source/text/scalc/01/05020000.xhp | 57 + helpcontent2/source/text/scalc/01/05020600.xhp | 59 + helpcontent2/source/text/scalc/01/05030000.xhp | 48 + helpcontent2/source/text/scalc/01/05030200.xhp | 53 + helpcontent2/source/text/scalc/01/05030300.xhp | 64 + helpcontent2/source/text/scalc/01/05030400.xhp | 50 + helpcontent2/source/text/scalc/01/05040000.xhp | 48 + helpcontent2/source/text/scalc/01/05040200.xhp | 54 + helpcontent2/source/text/scalc/01/05050000.xhp | 55 + helpcontent2/source/text/scalc/01/05050100.xhp | 56 + helpcontent2/source/text/scalc/01/05050300.xhp | 47 + helpcontent2/source/text/scalc/01/05060000.xhp | 88 + helpcontent2/source/text/scalc/01/05070000.xhp | 53 + helpcontent2/source/text/scalc/01/05070500.xhp | 100 ++ helpcontent2/source/text/scalc/01/05080000.xhp | 48 + helpcontent2/source/text/scalc/01/05080100.xhp | 42 + helpcontent2/source/text/scalc/01/05080200.xhp | 42 + helpcontent2/source/text/scalc/01/05080300.xhp | 63 + helpcontent2/source/text/scalc/01/05080400.xhp | 42 + helpcontent2/source/text/scalc/01/05100000.xhp | 165 ++ helpcontent2/source/text/scalc/01/05110000.xhp | 78 + helpcontent2/source/text/scalc/01/05120000.xhp | 183 ++ helpcontent2/source/text/scalc/01/06020000.xhp | 71 + helpcontent2/source/text/scalc/01/06030000.xhp | 55 + helpcontent2/source/text/scalc/01/06030100.xhp | 47 + helpcontent2/source/text/scalc/01/06030200.xhp | 45 + helpcontent2/source/text/scalc/01/06030300.xhp | 47 + helpcontent2/source/text/scalc/01/06030400.xhp | 45 + helpcontent2/source/text/scalc/01/06030500.xhp | 45 + helpcontent2/source/text/scalc/01/06030600.xhp | 45 + helpcontent2/source/text/scalc/01/06030700.xhp | 46 + helpcontent2/source/text/scalc/01/06030800.xhp | 46 + helpcontent2/source/text/scalc/01/06030900.xhp | 58 + helpcontent2/source/text/scalc/01/06031000.xhp | 46 + helpcontent2/source/text/scalc/01/06040000.xhp | 52 + helpcontent2/source/text/scalc/01/06050000.xhp | 80 + helpcontent2/source/text/scalc/01/06060000.xhp | 51 + helpcontent2/source/text/scalc/01/06060100.xhp | 109 ++ helpcontent2/source/text/scalc/01/06060200.xhp | 52 + helpcontent2/source/text/scalc/01/06070000.xhp | 45 + helpcontent2/source/text/scalc/01/06080000.xhp | 53 + helpcontent2/source/text/scalc/01/06130000.xhp | 61 + helpcontent2/source/text/scalc/01/07080000.xhp | 46 + helpcontent2/source/text/scalc/01/07090000.xhp | 46 + helpcontent2/source/text/scalc/01/07090100.xhp | 37 + helpcontent2/source/text/scalc/01/12010000.xhp | 57 + helpcontent2/source/text/scalc/01/12010100.xhp | 49 + helpcontent2/source/text/scalc/01/12020000.xhp | 48 + helpcontent2/source/text/scalc/01/12030000.xhp | 44 + helpcontent2/source/text/scalc/01/12030100.xhp | 61 + helpcontent2/source/text/scalc/01/12030200.xhp | 95 ++ helpcontent2/source/text/scalc/01/12040000.xhp | 44 + helpcontent2/source/text/scalc/01/12040100.xhp | 70 + helpcontent2/source/text/scalc/01/12040201.xhp | 76 + helpcontent2/source/text/scalc/01/12040300.xhp | 54 + helpcontent2/source/text/scalc/01/12040400.xhp | 44 + helpcontent2/source/text/scalc/01/12040500.xhp | 45 + helpcontent2/source/text/scalc/01/12050000.xhp | 49 + helpcontent2/source/text/scalc/01/12050100.xhp | 52 + helpcontent2/source/text/scalc/01/12050200.xhp | 58 + helpcontent2/source/text/scalc/01/12060000.xhp | 56 + helpcontent2/source/text/scalc/01/12070000.xhp | 65 + helpcontent2/source/text/scalc/01/12070100.xhp | 49 + helpcontent2/source/text/scalc/01/12080000.xhp | 55 + helpcontent2/source/text/scalc/01/12080100.xhp | 46 + helpcontent2/source/text/scalc/01/12080200.xhp | 47 + helpcontent2/source/text/scalc/01/12080300.xhp | 54 + helpcontent2/source/text/scalc/01/12080400.xhp | 49 + helpcontent2/source/text/scalc/01/12080500.xhp | 93 ++ helpcontent2/source/text/scalc/01/12080600.xhp | 44 + helpcontent2/source/text/scalc/01/12080700.xhp | 40 + helpcontent2/source/text/scalc/01/12090000.xhp | 41 + helpcontent2/source/text/scalc/01/12090100.xhp | 53 + helpcontent2/source/text/scalc/01/12090101.xhp | 57 + helpcontent2/source/text/scalc/01/12090102.xhp | 107 ++ helpcontent2/source/text/scalc/01/12090103.xhp | 114 ++ helpcontent2/source/text/scalc/01/12090104.xhp | 52 + helpcontent2/source/text/scalc/01/12090105.xhp | 168 ++ helpcontent2/source/text/scalc/01/12090106.xhp | 70 + helpcontent2/source/text/scalc/01/12090200.xhp | 43 + helpcontent2/source/text/scalc/01/12090300.xhp | 39 + helpcontent2/source/text/scalc/01/12090400.xhp | 59 + helpcontent2/source/text/scalc/01/12100000.xhp | 41 + helpcontent2/source/text/scalc/01/12120000.xhp | 45 + helpcontent2/source/text/scalc/01/12120100.xhp | 157 ++ helpcontent2/source/text/scalc/01/12120200.xhp | 54 + helpcontent2/source/text/scalc/01/12120300.xhp | 83 + helpcontent2/source/text/scalc/01/ODFF.xhp | 25 + helpcontent2/source/text/scalc/01/calculate.xhp | 32 + .../source/text/scalc/01/calculation_accuracy.xhp | 108 ++ helpcontent2/source/text/scalc/01/cell_styles.xhp | 38 + helpcontent2/source/text/scalc/01/common_func.xhp | 40 + .../text/scalc/01/common_func_workdaysintl.xhp | 163 ++ helpcontent2/source/text/scalc/01/data_form.xhp | 72 + .../source/text/scalc/01/data_provider.xhp | 52 + .../source/text/scalc/01/databar_more_options.xhp | 73 + .../source/text/scalc/01/ex_data_stat_func.xhp | 162 ++ .../source/text/scalc/01/exponsmooth_embd.xhp | 386 +++++ .../source/text/scalc/01/format_graphic.xhp | 46 + .../source/text/scalc/01/formula2value.xhp | 36 + helpcontent2/source/text/scalc/01/ful_func.xhp | 93 ++ .../source/text/scalc/01/func_aggregate.xhp | 441 +++++ helpcontent2/source/text/scalc/01/func_arabic.xhp | 42 + helpcontent2/source/text/scalc/01/func_asc.xhp | 42 + .../source/text/scalc/01/func_averageif.xhp | 84 + .../source/text/scalc/01/func_averageifs.xhp | 74 + helpcontent2/source/text/scalc/01/func_ceiling.xhp | 150 ++ helpcontent2/source/text/scalc/01/func_color.xhp | 53 + helpcontent2/source/text/scalc/01/func_concat.xhp | 43 + helpcontent2/source/text/scalc/01/func_convert.xhp | 1744 ++++++++++++++++++++ .../source/text/scalc/01/func_countifs.xhp | 76 + helpcontent2/source/text/scalc/01/func_date.xhp | 50 + helpcontent2/source/text/scalc/01/func_datedif.xhp | 113 ++ .../source/text/scalc/01/func_datevalue.xhp | 51 + helpcontent2/source/text/scalc/01/func_day.xhp | 46 + helpcontent2/source/text/scalc/01/func_days.xhp | 46 + helpcontent2/source/text/scalc/01/func_days360.xhp | 45 + .../source/text/scalc/01/func_eastersunday.xhp | 50 + helpcontent2/source/text/scalc/01/func_edate.xhp | 49 + helpcontent2/source/text/scalc/01/func_eomonth.xhp | 49 + .../source/text/scalc/01/func_error_type.xhp | 129 ++ helpcontent2/source/text/scalc/01/func_findb.xhp | 45 + helpcontent2/source/text/scalc/01/func_floor.xhp | 132 ++ .../source/text/scalc/01/func_forecastetsadd.xhp | 64 + .../source/text/scalc/01/func_forecastetsmult.xhp | 65 + .../source/text/scalc/01/func_forecastetspiadd.xhp | 69 + .../text/scalc/01/func_forecastetspimult.xhp | 69 + .../text/scalc/01/func_forecastetsseason.xhp | 61 + .../text/scalc/01/func_forecastetsstatadd.xhp | 67 + .../text/scalc/01/func_forecastetsstatmult.xhp | 66 + helpcontent2/source/text/scalc/01/func_fourier.xhp | 51 + helpcontent2/source/text/scalc/01/func_hour.xhp | 46 + helpcontent2/source/text/scalc/01/func_ifs.xhp | 51 + helpcontent2/source/text/scalc/01/func_imcos.xhp | 72 + helpcontent2/source/text/scalc/01/func_imcosh.xhp | 73 + helpcontent2/source/text/scalc/01/func_imcot.xhp | 71 + helpcontent2/source/text/scalc/01/func_imcsc.xhp | 73 + helpcontent2/source/text/scalc/01/func_imcsch.xhp | 73 + helpcontent2/source/text/scalc/01/func_imsec.xhp | 73 + helpcontent2/source/text/scalc/01/func_imsech.xhp | 73 + helpcontent2/source/text/scalc/01/func_imsin.xhp | 72 + helpcontent2/source/text/scalc/01/func_imsinh.xhp | 73 + helpcontent2/source/text/scalc/01/func_imtan.xhp | 71 + .../source/text/scalc/01/func_isoweeknum.xhp | 48 + helpcontent2/source/text/scalc/01/func_jis.xhp | 41 + helpcontent2/source/text/scalc/01/func_maxifs.xhp | 78 + helpcontent2/source/text/scalc/01/func_minifs.xhp | 79 + helpcontent2/source/text/scalc/01/func_minute.xhp | 48 + helpcontent2/source/text/scalc/01/func_month.xhp | 46 + .../source/text/scalc/01/func_networkdays.intl.xhp | 61 + .../source/text/scalc/01/func_networkdays.xhp | 59 + helpcontent2/source/text/scalc/01/func_now.xhp | 44 + .../source/text/scalc/01/func_numbervalue.xhp | 60 + .../source/text/scalc/01/func_opt_barrier.xhp | 58 + .../source/text/scalc/01/func_opt_prob_hit.xhp | 56 + .../source/text/scalc/01/func_opt_prob_inmoney.xhp | 65 + .../source/text/scalc/01/func_opt_touch.xhp | 92 ++ .../source/text/scalc/01/func_rawsubtract.xhp | 43 + helpcontent2/source/text/scalc/01/func_regex.xhp | 51 + .../source/text/scalc/01/func_replaceb.xhp | 50 + helpcontent2/source/text/scalc/01/func_roman.xhp | 46 + .../source/text/scalc/01/func_rounddown.xhp | 52 + .../source/text/scalc/01/func_roundsig.xhp | 48 + helpcontent2/source/text/scalc/01/func_searchb.xhp | 46 + helpcontent2/source/text/scalc/01/func_second.xhp | 46 + helpcontent2/source/text/scalc/01/func_skewp.xhp | 52 + helpcontent2/source/text/scalc/01/func_sum.xhp | 48 + helpcontent2/source/text/scalc/01/func_sumifs.xhp | 73 + helpcontent2/source/text/scalc/01/func_switch.xhp | 47 + .../source/text/scalc/01/func_textjoin.xhp | 48 + helpcontent2/source/text/scalc/01/func_time.xhp | 47 + .../source/text/scalc/01/func_timevalue.xhp | 46 + helpcontent2/source/text/scalc/01/func_today.xhp | 44 + helpcontent2/source/text/scalc/01/func_trunc.xhp | 54 + helpcontent2/source/text/scalc/01/func_value.xhp | 47 + .../source/text/scalc/01/func_webservice.xhp | 82 + helpcontent2/source/text/scalc/01/func_weekday.xhp | 151 ++ helpcontent2/source/text/scalc/01/func_weeknum.xhp | 184 +++ .../source/text/scalc/01/func_weeknum_ooo.xhp | 55 + .../source/text/scalc/01/func_weeknumadd.xhp | 47 + .../source/text/scalc/01/func_workday.intl.xhp | 66 + helpcontent2/source/text/scalc/01/func_workday.xhp | 57 + helpcontent2/source/text/scalc/01/func_year.xhp | 50 + .../source/text/scalc/01/func_yearfrac.xhp | 100 ++ .../source/text/scalc/01/live_data_stream.xhp | 76 + .../source/text/scalc/01/recalculate_hard.xhp | 37 + .../source/text/scalc/01/shared_spreadsheet.xhp | 47 + helpcontent2/source/text/scalc/01/solver.xhp | 153 ++ .../source/text/scalc/01/solver_options.xhp | 80 + .../source/text/scalc/01/solver_options_algo.xhp | 386 +++++ helpcontent2/source/text/scalc/01/sparklines.xhp | 91 + helpcontent2/source/text/scalc/01/stat_data.xhp | 1337 +++++++++++++++ helpcontent2/source/text/scalc/01/statistics.xhp | 49 + .../source/text/scalc/01/statistics_anova.xhp | 271 +++ .../text/scalc/01/statistics_correlation.xhp | 101 ++ .../source/text/scalc/01/statistics_covariance.xhp | 97 ++ .../text/scalc/01/statistics_descriptive.xhp | 240 +++ .../source/text/scalc/01/statistics_exposmooth.xhp | 177 ++ .../source/text/scalc/01/statistics_fourier.xhp | 652 ++++++++ .../source/text/scalc/01/statistics_movingavg.xhp | 155 ++ .../source/text/scalc/01/statistics_regression.xhp | 85 + .../source/text/scalc/01/statistics_sampling.xhp | 242 +++ .../text/scalc/01/statistics_test_chisqr.xhp | 91 + .../source/text/scalc/01/statistics_test_f.xhp | 191 +++ .../source/text/scalc/01/statistics_test_t.xhp | 211 +++ .../source/text/scalc/01/statistics_test_z.xhp | 188 +++ helpcontent2/source/text/scalc/01/text2columns.xhp | 64 + helpcontent2/source/text/scalc/01/xml_source.xhp | 81 + 274 files changed, 35462 insertions(+) create mode 100644 helpcontent2/source/text/scalc/01/01120000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02110000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02120000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02120100.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140100.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140200.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140300.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140400.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140500.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140600.xhp create mode 100644 helpcontent2/source/text/scalc/01/02140700.xhp create mode 100644 helpcontent2/source/text/scalc/01/02150000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02160000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02170000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02180000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02190000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02190100.xhp create mode 100644 helpcontent2/source/text/scalc/01/02190200.xhp create mode 100644 helpcontent2/source/text/scalc/01/02200000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02210000.xhp create mode 100644 helpcontent2/source/text/scalc/01/02220000.xhp create mode 100644 helpcontent2/source/text/scalc/01/03070000.xhp create mode 100644 helpcontent2/source/text/scalc/01/03080000.xhp create mode 100644 helpcontent2/source/text/scalc/01/03090000.xhp create mode 100644 helpcontent2/source/text/scalc/01/03100000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04010000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04010100.xhp create mode 100644 helpcontent2/source/text/scalc/01/04010200.xhp create mode 100644 helpcontent2/source/text/scalc/01/04020000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04030000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04040000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04050000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04050100.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060100.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060101.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060102.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060103.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060104.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060105.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060106.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060107.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060108.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060109.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060110.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060111.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060112.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060115.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060116.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060118.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060119.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060120.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060181.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060182.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060183.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060184.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060185.xhp create mode 100644 helpcontent2/source/text/scalc/01/04060199.xhp create mode 100644 helpcontent2/source/text/scalc/01/04070000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04070100.xhp create mode 100644 helpcontent2/source/text/scalc/01/04070200.xhp create mode 100644 helpcontent2/source/text/scalc/01/04070300.xhp create mode 100644 helpcontent2/source/text/scalc/01/04070400.xhp create mode 100644 helpcontent2/source/text/scalc/01/04080000.xhp create mode 100644 helpcontent2/source/text/scalc/01/04090000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05020000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05020600.xhp create mode 100644 helpcontent2/source/text/scalc/01/05030000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05030200.xhp create mode 100644 helpcontent2/source/text/scalc/01/05030300.xhp create mode 100644 helpcontent2/source/text/scalc/01/05030400.xhp create mode 100644 helpcontent2/source/text/scalc/01/05040000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05040200.xhp create mode 100644 helpcontent2/source/text/scalc/01/05050000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05050100.xhp create mode 100644 helpcontent2/source/text/scalc/01/05050300.xhp create mode 100644 helpcontent2/source/text/scalc/01/05060000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05070000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05070500.xhp create mode 100644 helpcontent2/source/text/scalc/01/05080000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05080100.xhp create mode 100644 helpcontent2/source/text/scalc/01/05080200.xhp create mode 100644 helpcontent2/source/text/scalc/01/05080300.xhp create mode 100644 helpcontent2/source/text/scalc/01/05080400.xhp create mode 100644 helpcontent2/source/text/scalc/01/05100000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05110000.xhp create mode 100644 helpcontent2/source/text/scalc/01/05120000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06020000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030100.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030200.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030300.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030400.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030500.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030600.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030700.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030800.xhp create mode 100644 helpcontent2/source/text/scalc/01/06030900.xhp create mode 100644 helpcontent2/source/text/scalc/01/06031000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06040000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06050000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06060000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06060100.xhp create mode 100644 helpcontent2/source/text/scalc/01/06060200.xhp create mode 100644 helpcontent2/source/text/scalc/01/06070000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06080000.xhp create mode 100644 helpcontent2/source/text/scalc/01/06130000.xhp create mode 100644 helpcontent2/source/text/scalc/01/07080000.xhp create mode 100644 helpcontent2/source/text/scalc/01/07090000.xhp create mode 100644 helpcontent2/source/text/scalc/01/07090100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12010000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12010100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12020000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12030000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12030100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12030200.xhp create mode 100644 helpcontent2/source/text/scalc/01/12040000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12040100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12040201.xhp create mode 100644 helpcontent2/source/text/scalc/01/12040300.xhp create mode 100644 helpcontent2/source/text/scalc/01/12040400.xhp create mode 100644 helpcontent2/source/text/scalc/01/12040500.xhp create mode 100644 helpcontent2/source/text/scalc/01/12050000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12050100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12050200.xhp create mode 100644 helpcontent2/source/text/scalc/01/12060000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12070000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12070100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080200.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080300.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080400.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080500.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080600.xhp create mode 100644 helpcontent2/source/text/scalc/01/12080700.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090101.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090102.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090103.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090104.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090105.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090106.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090200.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090300.xhp create mode 100644 helpcontent2/source/text/scalc/01/12090400.xhp create mode 100644 helpcontent2/source/text/scalc/01/12100000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12120000.xhp create mode 100644 helpcontent2/source/text/scalc/01/12120100.xhp create mode 100644 helpcontent2/source/text/scalc/01/12120200.xhp create mode 100644 helpcontent2/source/text/scalc/01/12120300.xhp create mode 100644 helpcontent2/source/text/scalc/01/ODFF.xhp create mode 100644 helpcontent2/source/text/scalc/01/calculate.xhp create mode 100644 helpcontent2/source/text/scalc/01/calculation_accuracy.xhp create mode 100644 helpcontent2/source/text/scalc/01/cell_styles.xhp create mode 100644 helpcontent2/source/text/scalc/01/common_func.xhp create mode 100644 helpcontent2/source/text/scalc/01/common_func_workdaysintl.xhp create mode 100644 helpcontent2/source/text/scalc/01/data_form.xhp create mode 100644 helpcontent2/source/text/scalc/01/data_provider.xhp create mode 100644 helpcontent2/source/text/scalc/01/databar_more_options.xhp create mode 100644 helpcontent2/source/text/scalc/01/ex_data_stat_func.xhp create mode 100644 helpcontent2/source/text/scalc/01/exponsmooth_embd.xhp create mode 100644 helpcontent2/source/text/scalc/01/format_graphic.xhp create mode 100644 helpcontent2/source/text/scalc/01/formula2value.xhp create mode 100644 helpcontent2/source/text/scalc/01/ful_func.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_aggregate.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_arabic.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_asc.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_averageif.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_averageifs.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_ceiling.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_color.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_concat.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_convert.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_countifs.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_date.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_datedif.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_datevalue.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_day.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_days.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_days360.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_eastersunday.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_edate.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_eomonth.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_error_type.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_findb.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_floor.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_forecastetsadd.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_forecastetsmult.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_forecastetspiadd.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_forecastetspimult.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_forecastetsseason.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_forecastetsstatadd.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_forecastetsstatmult.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_fourier.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_hour.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_ifs.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imcos.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imcosh.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imcot.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imcsc.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imcsch.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imsec.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imsech.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imsin.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imsinh.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_imtan.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_isoweeknum.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_jis.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_maxifs.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_minifs.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_minute.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_month.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_networkdays.intl.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_networkdays.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_now.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_numbervalue.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_opt_barrier.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_opt_prob_hit.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_opt_prob_inmoney.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_opt_touch.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_rawsubtract.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_regex.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_replaceb.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_roman.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_rounddown.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_roundsig.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_searchb.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_second.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_skewp.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_sum.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_sumifs.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_switch.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_textjoin.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_time.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_timevalue.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_today.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_trunc.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_value.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_webservice.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_weekday.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_weeknum.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_weeknum_ooo.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_weeknumadd.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_workday.intl.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_workday.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_year.xhp create mode 100644 helpcontent2/source/text/scalc/01/func_yearfrac.xhp create mode 100644 helpcontent2/source/text/scalc/01/live_data_stream.xhp create mode 100644 helpcontent2/source/text/scalc/01/recalculate_hard.xhp create mode 100644 helpcontent2/source/text/scalc/01/shared_spreadsheet.xhp create mode 100644 helpcontent2/source/text/scalc/01/solver.xhp create mode 100644 helpcontent2/source/text/scalc/01/solver_options.xhp create mode 100644 helpcontent2/source/text/scalc/01/solver_options_algo.xhp create mode 100644 helpcontent2/source/text/scalc/01/sparklines.xhp create mode 100644 helpcontent2/source/text/scalc/01/stat_data.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_anova.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_correlation.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_covariance.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_descriptive.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_exposmooth.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_fourier.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_movingavg.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_regression.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_sampling.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_test_chisqr.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_test_f.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_test_t.xhp create mode 100644 helpcontent2/source/text/scalc/01/statistics_test_z.xhp create mode 100644 helpcontent2/source/text/scalc/01/text2columns.xhp create mode 100644 helpcontent2/source/text/scalc/01/xml_source.xhp (limited to 'helpcontent2/source/text/scalc/01') diff --git a/helpcontent2/source/text/scalc/01/01120000.xhp b/helpcontent2/source/text/scalc/01/01120000.xhp new file mode 100644 index 000000000..058adc0fb --- /dev/null +++ b/helpcontent2/source/text/scalc/01/01120000.xhp @@ -0,0 +1,49 @@ + + + + + + + + + + +Print Preview +/text/scalc/01/01120000.xhp + + + +
+ +Print Preview +Displays a preview of the printed page or closes the preview. +
+
+ +
+Use the icons on the Print Preview Bar to scroll through the pages of the document or to print the document. +You can also press CommandCtrl+Page Up and CommandCtrl+Page Down keys to scroll through the pages. +You cannot edit your document while you are in the print preview. + +To exit the print preview, click the Close Preview button. +
+Page View Object Bar +
+ + diff --git a/helpcontent2/source/text/scalc/01/02110000.xhp b/helpcontent2/source/text/scalc/01/02110000.xhp new file mode 100644 index 000000000..f566781ee --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02110000.xhp @@ -0,0 +1,167 @@ + + + + + + +Navigator +/text/scalc/01/02110000.xhp + + + + +
+ +
+ +Choose View - Navigator to display the Navigator. + +

Column

+Enter the column letter. Press Enter to reposition the cell cursor to the specified column in the same row. + +

Row

+Enter a row number. Press Enter to reposition the cell cursor to the specified row in the same column. + +

Data Range

+Specifies the current data range denoted by the position of the cell cursor. + + + + +Icon + + + +Data Range + + +
+ + +

Start

+Moves to the cell at the beginning of the current data range, which you can highlight using the Data Range button. + + + + +Icon Start + + + +Start + + +
+ + +

End

+Moves to the cell at the end of the current data range, which you can highlight using the Data Range button. + + + + +Icon End + + +End + + +
+ +

Toggle

+Toggles the content view. Only the selected Navigator element and its subelements are displayed. Click the icon again to restore all elements for viewing. + + + + +Icon Toggle + + +Toggle + + +
+ + +

Scenarios

+Displays all available scenarios. Double-click a name to apply that scenario. The result is shown in the sheet. For more information, choose Tools - Scenarios. + + + + +Icon Scenarios + + +Scenarios + + +
+ +If the Navigator displays scenarios, you can access the following commands when you right-click a scenario entry: + +

Delete

+Deletes the selected scenario. + +

Properties

+Opens the Edit scenario dialog, where you can edit the scenario properties. + +

Drag Mode

+Opens a submenu for selecting the drag mode. You decide which action is performed when dragging and dropping an object from the Navigator into a document. Depending on the mode you select, the icon indicates whether a hyperlink, link or a copy is created. + + + + +Icon Drag Mode + + +Drag Mode + + +
+ + +

Insert as Hyperlink

+Inserts a hyperlink when you drag-and-drop an object from the Navigator into a document. You can later click the created hyperlink to set the cursor and the view to the respective object. +If you insert a hyperlink that links to an open document, you need to save the document before you can use the hyperlink. + +

Insert as Link

+Creates a link when you drag-and-drop an object from the Navigator into a document. + +

Insert as Copy

+Generates a copy when you drag-and-drop an object from the Navigator into a document. + +

Objects

+Displays all objects in your document. + +

Documents

+Displays the names of all open documents. To switch to another open document in the Navigator, click the document name. The status (active, inactive) of the document is shown in brackets after the name. You can switch the active document in the Window menu. + + diff --git a/helpcontent2/source/text/scalc/01/02120000.xhp b/helpcontent2/source/text/scalc/01/02120000.xhp new file mode 100644 index 000000000..53214c215 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02120000.xhp @@ -0,0 +1,40 @@ + + + + + + + Headers & Footers + /text/scalc/01/02120000.xhp + + + +
+ +Headers & Footers +Allows you to define and format headers and footers. +
+The Headers/Footers dialog contains the tabs for defining headers and footers. There will be separate tabs for the left and right page headers and footers if the Same content left/right option was not marked in the Page Style dialog. +
+ +
+ + + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/02120100.xhp b/helpcontent2/source/text/scalc/01/02120100.xhp new file mode 100644 index 000000000..7ca98d272 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02120100.xhp @@ -0,0 +1,164 @@ + + + + + + + + Header/Footer + /text/scalc/01/02120100.xhp + + + + +
+ +
+ +Left Area + Enter the text to be displayed at the left side of the header or footer. + +Center Area + Enter the text to be displayed at the center of the header or footer. + +Right Area + Enter the text to be displayed at the right side of the header or footer. + +Header/Footer + Select a predefined header or footer from the list. + +Text attributes + Opens a dialog to assign formats to new or selected text. The Text Attributes dialog contains the tab pages Font, Font Effects and Font Position. + + + + +Icon + + + Text Attributes + + +
+ + +File Name + Inserts a file name placeholder in the selected area. Click to insert the title. Long-click UFI: this is still a long-clickto select either title, file name or path/file name from the submenu. If a title has not be assigned (see File - Properties), the file name will be inserted instead. + + + + +Icon + + + File Name + + +
+ + +Sheet Name + Inserts a placeholder in the selected header/footer area, which is replaced by the sheet name in the header/footer of the actual document. + + + + +Icon + + + Sheet Name + + +
+ + +Page + Inserts a placeholder in the selected header/footer area, which is replaced by page numbering. This allows continuous page numbering in a document. + + + + +Icon + + + Page + + +
+ + +Pages + Inserts a placeholder in the selected header/footer area, which is replaced by the total number of pages in the document. + + + + +Icon + + + Pages + + +
+ + +Date + Inserts a placeholder in the selected header/footer area, which is replaced by the current date which will be repeated in the header/footer on each page of the document. + + + + +Icon + + + Date + + +
+ + +Time + Inserts a placeholder in the selected header/footer area, which is replaced by the current time in the header/footer on each page of the document. + + + + +Icon + + + Time + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/02140000.xhp b/helpcontent2/source/text/scalc/01/02140000.xhp new file mode 100644 index 000000000..50893fb3b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140000.xhp @@ -0,0 +1,66 @@ + + + + + + + + + Fill + /text/scalc/01/02140000.xhp + + + +
+ +filling;selection lists + selection lists;filling cells +MW inserted 2 index entries +Fill + Automatically fills cells with content. +
+
+ +
+ The $[officename] Calc context menus have additional options for filling the cells. + + + + + Sheet + + Series + + +Filling cells using context menus: + + + + Call the context menu when positioned in a cell and choose Selection List. + + + +A list box containing all text found in the current column is displayed. The text is sorted alphabetically and multiple entries are listed only once. + + + Click one of the listed entries to copy it to the cell. + + + + diff --git a/helpcontent2/source/text/scalc/01/02140100.xhp b/helpcontent2/source/text/scalc/01/02140100.xhp new file mode 100644 index 000000000..aef7a17d6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140100.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Down +/text/scalc/01/02140100.xhp + + +Sun Microsystems, Inc. + + + + + +
+ +Down + Fills a selected range of at least two rows with the contents of the top cell of the range. +
+
+ +
+ If a selected range has only one column, the contents of the top cell are copied to all others. If several columns are selected, the contents of the corresponding top cell will be copied down. + + diff --git a/helpcontent2/source/text/scalc/01/02140200.xhp b/helpcontent2/source/text/scalc/01/02140200.xhp new file mode 100644 index 000000000..a05a478d3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140200.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Right +/text/scalc/01/02140200.xhp + + +Sun Microsystems, Inc. + + + + + + +
+ +
+ If a range of only one row is selected, the contents of the far left cell are copied to all the other selected cells. If you have selected several rows, each of the far left cells is copied into those cells to the right. + + diff --git a/helpcontent2/source/text/scalc/01/02140300.xhp b/helpcontent2/source/text/scalc/01/02140300.xhp new file mode 100644 index 000000000..a5db87e3e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140300.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Up +/text/scalc/01/02140300.xhp + + +Sun Microsystems, Inc. + + + + + +
+ +Up + Fills a selected range of at least two rows with the contents of the bottom most cell. +
+
+ +
+ If a selected range has only one column, the content of the bottom most cell is copied into the selected cells. If several columns are selected, the contents of the bottom most cells are copied into those selected above. + + diff --git a/helpcontent2/source/text/scalc/01/02140400.xhp b/helpcontent2/source/text/scalc/01/02140400.xhp new file mode 100644 index 000000000..a96720e8e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140400.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Left +/text/scalc/01/02140400.xhp + + +Sun Microsystems, Inc. + + + + + +
+ +Left + Fills a selected range of at least two columns with the contents of the far right cell. +
+
+ +
+ If a selected range has only one row, the content of the far right cell is copied into all other cells of the range. If several rows are selected, the far right cells are copied into the cells to the left. + + diff --git a/helpcontent2/source/text/scalc/01/02140500.xhp b/helpcontent2/source/text/scalc/01/02140500.xhp new file mode 100644 index 000000000..c3888d425 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140500.xhp @@ -0,0 +1,53 @@ + + + + + + Fill Sheets + /text/scalc/01/02140500.xhp + + + + +

Fill Sheets

+Specifies the options for transferring sheets or ranges of a certain sheet to the same cells on other selected sheets. +
+ +
+This menu command is only active if you have selected at least two sheets in the document. +To select multiple sheets, click each sheet tab while pressing CommandCtrl or Shift. +In contrast to copying an area to the clipboard, you can filter certain information and calculate values. +

Filling a Sheet

+ + + Select the entire sheet by clicking the empty gray box in the upper left of the sheet. You can also select an area of the sheet to be copied. + + + Press CommandCtrl and click the tab of the sheet where you want to insert the contents. + + + Select the command Sheet - Fill Cells - Sheets. In the dialog which appears, the check box Numbers must be selected (or Paste All) if you want to combine operations with the values. You can also choose the desired operation here. + + + Click OK. + + + This dialog is similar to the Paste Special dialog, where you can find additional tips. + + diff --git a/helpcontent2/source/text/scalc/01/02140600.xhp b/helpcontent2/source/text/scalc/01/02140600.xhp new file mode 100644 index 000000000..da3139a68 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140600.xhp @@ -0,0 +1,115 @@ + + + + + + + Fill Series + /text/scalc/01/02140600.xhp + + + + + + + + + +Fill Series +Automatically generate series with the options in this dialog. Determine direction, increment, time unit and series type. +Before filling a series, first select the cell range. + +
+ +
+To automatically continue a series using the assumed completion rules, choose the AutoFill option after opening the Fill Series dialog. + +Direction +Determines the direction of series creation. + + +Down +Creates a downward series in the selected cell range for the column using the defined increment to the end value. + + +Right +Creates a series running from left to right within the selected cell range using the defined increment to the end value. + + +Up +Creates an upward series in the cell range of the column using the defined increment to the end value. + + +Left +Creates a series running from right to left in the selected cell range using the defined increment to the end value. + +Series Type +Defines the series type. Choose between Linear, Growth, Date and AutoFill. + + +Linear +Creates a linear number series using the defined increment and end value. + + +Growth +Creates a growth series using the defined increment and end value. + + +Date +Creates a date series using the defined increment and end date. + + +AutoFill +Forms a series directly in the sheet. The AutoFill function takes account of customized lists. For example, by entering January in the first cell, the series is completed using the list defined under %PRODUCTNAME - Preferences +Tools - Options - %PRODUCTNAME Calc - Sort Lists. +AutoFill tries to complete a value series by using a defined pattern. The series 1,3,5 is automatically completed with 7,9,11,13, and so on. Date and time series are completed accordingly; for example, after 01.01.99 and 15.01.99, an interval of 14 days is used. + + +Unit of Time +In this area you can specify the desired unit of time. This area is only active if the Date option has been chosen in the Series type area. + + +Day +Use the Date series type and this option to create a series using all seven days of the week. Unit of Increment is day. + + +Weekday +Use the Date series type and this option to create a series only using the five weekdays. Unit of Increment is day. + + +Month +Use the Date series type and this option to form a series which unit of Increment is month. + + +Year +Use the Date series type and this option to create a series which unit of Increment is year. + + +Start Value +Determines the start value for the series. Use numbers, dates or times. + + +End Value +Determines the end value for the series. Use numbers, dates or times. + + +Increment +The term "increment" denotes the amount by which a given value increases. Determines the value by which the series of the selected type increases by each step. Entries can only be made if the linear, growth or date series types have been selected. + + diff --git a/helpcontent2/source/text/scalc/01/02140700.xhp b/helpcontent2/source/text/scalc/01/02140700.xhp new file mode 100644 index 000000000..bc5a8f191 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140700.xhp @@ -0,0 +1,194 @@ + + + + + + +Fill Random Numbers +/text/scalc/01/02140700.xhp + + + + + +Fill Random Numbers +Populate a cell range with automatically generated pseudo random numbers with the selected distribution function and its parameters. + +fill range;random numbers +random rumbers;fill range +random rumbers;distribution + +
+Choose Sheet - Fill Cells - Random Number +
+Data +Cell Range + +Define the range of cells to fill with random numbers. If you have previously selected a range, it will be displayed here. +Random number generator +Distribution + +The distribution function for the random number generator. +Valid distributions function and their parameters are + + + + + +Distribution + + +Parameters + + + + +Uniform + + + + +Minimum: The minimum value of the sample. + + +Maximum: The maximum value of the sample. + + + + + +Uniform Integer + + + + +Minimum: The minimum value of the sample. + + +Maximum: The maximum value of the sample. + + + + + +Normal + + + + +Mean: The mean of the Normal distribution. + + +Standard Deviation: The standard deviation of the Normal distribution. + +The mean and standard deviation of the numbers generated may not equal the Mean and Standard Deviation inserted in the dialog. + + + + +Cauchy + + + + +Median: the median of the data or location parameter. + + +Sigma: the scale parameter. + +The median and sigma of the generated numbers may not equal the data inserted in the dialog. + + + + +Bernoulli + + + + +p Value: The probability of success. + + + + + +Binomial + + + + +p Value: The probability of success of each trial. + + +Number of trials: the number of trials of the experiment. + + + + + +Chi Squared + + + + +Nu Value: a positive integer that specifies the number of degrees of freedom. + + + + + +Geometric + + + + +p Value: The probability of success of each trial. + + + + + +Negative Binomial + + + + +p Value: The probability of success of each trial. + + +Number of trials: the number of trials of the experiment. + + + +
+Options +Enable custom seed + +Set the initial value of the random number generator to a known value Seed. +Seed + +Value set to initiate the random number generator algorithm. It is used to initialize (seed) the random number generator in order to reproduce the same sequence of pseudorandom numbers. Specify a positive integer number (1, 2, ...) to produce a specific sequence, or leave the field blank if you don't need this particular feature. +Enable rounding + +Truncate the number to a given number of Decimal Places. +Decimal places + +Number of decimal places of the numbers generated. + + diff --git a/helpcontent2/source/text/scalc/01/02150000.xhp b/helpcontent2/source/text/scalc/01/02150000.xhp new file mode 100644 index 000000000..5721ab049 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02150000.xhp @@ -0,0 +1,70 @@ + + + + + + + + + + +Deleting Contents +/text/scalc/01/02150000.xhp + + + +
+deleting; cell contents +cells; deleting contents +spreadsheets; deleting cell contents +cell contents; deleting + + + + +Deleting Contents +Specifies the contents to be deleted from the active cell or from a selected cell range. + If several sheets are selected, all selected sheets will be affected. +
+
+ +
+This dialog is also called by pressing Backspace after the cell cursor has been activated on the sheet. +Pressing Delete deletes content without calling the dialog or changing formats. +Use Cut on the Standard bar to delete contents and formats without the dialog. +Selection +This area lists the options for deleting contents. +Delete All +Deletes all content from the selected cell range. +Texti50439 +Deletes text only. Formats, formulas, numbers and dates are not affected. +Numbers +Deletes numbers only. Formats and formulas remain unchanged. +Date & time +Deletes date and time values. Formats, text, numbers and formulas remain unchanged. +Formulas +Deletes formulas. Text, numbers, formats, dates and times remain unchanged. +Comments +Deletes comments added to cells. All other elements remain unchanged. +Formats +Deletes format attributes applied to cells. All cell content remains unchanged. +Objects +Deletes objects. All cell content remains unchanged. + + diff --git a/helpcontent2/source/text/scalc/01/02160000.xhp b/helpcontent2/source/text/scalc/01/02160000.xhp new file mode 100644 index 000000000..dd185bef7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02160000.xhp @@ -0,0 +1,82 @@ + + + + + + + + + + +Delete Cells +/text/scalc/01/02160000.xhp + + + + +
+ +cells; deleting cells +columns; deleting +rows; deleting +spreadsheets; deleting cells +deleting;cells/rows/columns + + MW made one "deleting;" entry out of 3 + + + + + Delete Cells + Completely deletes selected cells, columns or rows. The cells below or to the right of the deleted cells will fill the space. + Note that the selected delete option is stored and reloaded when the dialog is next called. +
+
+ + + +
+ Delete cells dialog + Selection + This area contains options for specifying how sheets are displayed after deleting cells. + + + Shift cells up + Fills the space produced by the deleted cells with the cells underneath it. + + + Shift cells left + Fills the resulting space by the cells to the right of the deleted cells. + + + + Delete entire row(s) + After selecting at least one cell, deletes the entire row from the sheet. + + + + Delete entire column(s) + After selecting at least one cell, deletes the entire column from the sheet. +
+ + Deleting Contents + +
+ + diff --git a/helpcontent2/source/text/scalc/01/02170000.xhp b/helpcontent2/source/text/scalc/01/02170000.xhp new file mode 100644 index 000000000..531253d84 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02170000.xhp @@ -0,0 +1,50 @@ + + + + + + + + +Delete Sheet +/text/scalc/01/02170000.xhp + + +Sun Microsystems, Inc. + + + +spreadsheets; deleting +sheets; deleting +deleting; spreadsheets + + + Delete Sheet +Deletes the current sheet after query confirmation. + +
+ +
+You cannot delete a sheet while Edit - Track Changes - Record is activated. +Yes +Deletes the current sheet. +No +Cancels the dialog. No delete is performed. + + diff --git a/helpcontent2/source/text/scalc/01/02180000.xhp b/helpcontent2/source/text/scalc/01/02180000.xhp new file mode 100644 index 000000000..d18b1e473 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02180000.xhp @@ -0,0 +1,58 @@ + + + + + + + + +Move or Copy a Sheet +/text/scalc/01/02180000.xhp + + +Sun Microsystems, Inc. + + + +spreadsheets; moving +spreadsheets; copying +moving; spreadsheets +copying; spreadsheets + + + + +Move or Copy a Sheet +Moves or copies a sheet to a new location in the document or to a different document. + +
+ +
+When you copy and paste cells containing date values between different spreadsheets, both spreadsheet documents must be set to the same date base. If date bases differ, the displayed date values will change! + +To Document +Indicates where the current sheet is to be moved or copied to. Select - new document - if you want to create a new location for the sheet to be moved or copied. + +Insert Before +The current sheet is moved or copied in front of the selected sheet. The - move to end position - option places the current sheet at the end. + +Copy +Specifies that the sheet is to be copied. If the option is unmarked, the sheet is moved. Moving sheets is the default. + + diff --git a/helpcontent2/source/text/scalc/01/02190000.xhp b/helpcontent2/source/text/scalc/01/02190000.xhp new file mode 100644 index 000000000..2e42de1b2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02190000.xhp @@ -0,0 +1,44 @@ + + + + + + + Delete Page Break + /text/scalc/01/02190000.xhp + + + + + +
+ + +Delete Page Break +Choose the type of page break that you want to delete. +
+ +
+ +
+ + + + + diff --git a/helpcontent2/source/text/scalc/01/02190100.xhp b/helpcontent2/source/text/scalc/01/02190100.xhp new file mode 100644 index 000000000..7c62fa602 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02190100.xhp @@ -0,0 +1,47 @@ + + + + + + + + +Row Break +/text/scalc/01/02190100.xhp + + +Sun Microsystems, Inc. + + + +
+spreadsheets; deleting row breaks +deleting;manual row breaks +row breaks; deleting +MW deleted "removing;..." and changed "deleting;...! + +Row Break +Removes the manual row break above the active cell. +
+Position the cursor in a cell directly below the row break indicated by a horizontal line and choose Sheet - Delete Page Break - Row Break. The manual row break is removed. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/02190200.xhp b/helpcontent2/source/text/scalc/01/02190200.xhp new file mode 100644 index 000000000..eccab059f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02190200.xhp @@ -0,0 +1,56 @@ + + + + + + + + + + +Column Break +/text/scalc/01/02190200.xhp + + + + + +
+ + +spreadsheets;deleting column breaks +deleting;manual column breaks +column breaks;deleting + + MW deleted "removing;" and changed "deleting;" + + + + Column Break + Removes a manual column break to the left of the active cell. + +
+ Position the cursor in the cell to the right of the column break indicated by a vertical line and choose Sheet - Delete Page Break - Column Break. The manual column break is removed. +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/02200000.xhp b/helpcontent2/source/text/scalc/01/02200000.xhp new file mode 100644 index 000000000..a8cb4735b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02200000.xhp @@ -0,0 +1,39 @@ + + + + + + + Sheet + /text/scalc/01/02200000.xhp + + + + + + +
+ + +Sheet +Edit commands for entire sheets. +
+ + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/02210000.xhp b/helpcontent2/source/text/scalc/01/02210000.xhp new file mode 100644 index 000000000..43f4cc522 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02210000.xhp @@ -0,0 +1,42 @@ + + + + + + + + +Selecting Sheets +/text/scalc/01/02210000.xhp + + +Sun Microsystems, Inc. + + + + + + +Selecting Sheets + Selects multiple sheets. + +Selected Sheets + Lists the sheets in the current document. To select a sheet, press the up or down arrow keys to move to a sheet in the list. To add a sheet to the selection, hold down CommandCtrl while pressing the arrow keys and then press Spacebar. To select a range of sheets, hold down Shift and press the arrow keys. + + diff --git a/helpcontent2/source/text/scalc/01/02220000.xhp b/helpcontent2/source/text/scalc/01/02220000.xhp new file mode 100644 index 000000000..8d5ae097c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02220000.xhp @@ -0,0 +1,38 @@ + + + + + +Go to Sheet +/text/scalc/01/02220000.xhp + + +LibreOffice + + + + + + + +Go to sheet +jump; to given sheet +sheet; go to directly +sheet; search and go to + +

Go to Sheet

+ Go to a specified sheet. + +

Type a sheet name

+ Type some characters contained in the searched sheet name. List of sheets will be limited to the sheet names containing these characters. +

Sheets

+ Lists the sheets in the current document. Hidden sheets are not listed. To select a sheet, press the up or down arrow keys to move to a sheet in the list. Double click on a name will directly jump to this sheet. + + diff --git a/helpcontent2/source/text/scalc/01/03070000.xhp b/helpcontent2/source/text/scalc/01/03070000.xhp new file mode 100644 index 000000000..a9ef012f3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03070000.xhp @@ -0,0 +1,58 @@ + + + + + + + Column & Row Headers + /text/scalc/01/03070000.xhp + + + + + + +
+ + spreadsheets; displaying headers of columns/rows + displaying; headers of columns/rows + + + + +Column & Row Headers +Shows column headers and row headers. +
+ + + + To hide the column and row headers, unmark this menu entry. + + +
+ +
+ + + + You can also set the view of the column and row headers in %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View. + + + + diff --git a/helpcontent2/source/text/scalc/01/03080000.xhp b/helpcontent2/source/text/scalc/01/03080000.xhp new file mode 100644 index 000000000..e51a75913 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03080000.xhp @@ -0,0 +1,55 @@ + + + + + + + Value Highlighting + /text/scalc/01/03080000.xhp + + + + + + +
+ + spreadsheets; value highlighting + values;highlighting + highlighting; values in sheets + colors;values + + + + +Value Highlighting +Displays cell contents in different colors, depending on type. +
+To remove the highlighting, unmark the menu entry. + +
+ +
+By default: +Text cells are formatted in black, formulas in green, number cells in blue, and protected cells are shown with light grey background, no matter how their display is formatted. +These colors can be customized in %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME - Application Colors. +If this function is active, colors that you define in the document will not be displayed. When you deactivate the function, the user-defined colors are displayed again. + + + diff --git a/helpcontent2/source/text/scalc/01/03090000.xhp b/helpcontent2/source/text/scalc/01/03090000.xhp new file mode 100644 index 000000000..1ced423ed --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03090000.xhp @@ -0,0 +1,50 @@ + + + + + + + Formula Bar + /text/scalc/01/03090000.xhp + + + + + + +
+ + formula bar;spreadsheets + spreadsheets; formula bar + + + + +Formula Bar +Shows or hides the Formula Bar, which is used for entering and editing formulas. The Formula Bar is the most important tool when working with spreadsheets. +
+To hide the Formula Bar, unmark the menu item. + +
+ +
+If the Formula Bar is hidden, you can still edit cells by activating the edit mode with F2. After editing cells, accept the changes by pressing Enter, or discard entries by pressing Esc. Esc is also used to exit the edit mode. + + + diff --git a/helpcontent2/source/text/scalc/01/03100000.xhp b/helpcontent2/source/text/scalc/01/03100000.xhp new file mode 100644 index 000000000..8228e4b20 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03100000.xhp @@ -0,0 +1,53 @@ + + + + + + + Page Break View + /text/scalc/01/03100000.xhp + + + + + + +
+ + +Page Break View +Display the page breaks and print ranges in the sheet. Choose View - Normal to switch this mode off. +
+ +
+ +
+ + +The context menu of the page break preview contains functions for editing page breaks, including the following options: + + +Delete Page Breaks +Deletes all manual breaks in the current sheet. + +Add Print Range +Adds the selected cells to print ranges. + + + diff --git a/helpcontent2/source/text/scalc/01/04010000.xhp b/helpcontent2/source/text/scalc/01/04010000.xhp new file mode 100644 index 000000000..00344263a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04010000.xhp @@ -0,0 +1,49 @@ + + + + + + + + +Insert Page Break +/text/scalc/01/04010000.xhp + + +Sun Microsystems, Inc. + + + +
+spreadsheets; inserting breaks in +inserting; breaks +page breaks; inserting in spreadsheets +mw changed "page breaks;..." + +Insert Page Break +This command inserts manual row or column breaks to ensure that your data prints properly. You can insert a horizontal page break above, or a vertical page break to the left of, the active cell. +
+Choose Sheet - Delete Page Break to remove breaks created manually. +
+ +
+ + + + diff --git a/helpcontent2/source/text/scalc/01/04010100.xhp b/helpcontent2/source/text/scalc/01/04010100.xhp new file mode 100644 index 000000000..c6c8824b6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04010100.xhp @@ -0,0 +1,48 @@ + + + + + + + + +Row Break +/text/scalc/01/04010100.xhp + + +Sun Microsystems, Inc. + + + +
+sheets; inserting row breaks +row breaks; inserting +inserting; manual row breaks +manual row breaks + + +Row Break +Inserts a row break (horizontal page break) above the selected cell. +
+The manual row break is indicated by a dark blue horizontal line. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04010200.xhp b/helpcontent2/source/text/scalc/01/04010200.xhp new file mode 100644 index 000000000..c2f81fbd4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04010200.xhp @@ -0,0 +1,48 @@ + + + + + + + + +Column Break +/text/scalc/01/04010200.xhp + + +Sun Microsystems, Inc. + + + +
+spreadsheets; inserting column breaks +column breaks; inserting +inserting; manual column breaks +manual column breaks + + +Column Break +Inserts a column break (vertical page break) to the left of the active cell. +
+The manual column break is indicated by a dark blue vertical line. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04020000.xhp b/helpcontent2/source/text/scalc/01/04020000.xhp new file mode 100644 index 000000000..3d9ccd2dd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04020000.xhp @@ -0,0 +1,68 @@ + + + + + + + + + + +Insert Cells +/text/scalc/01/04020000.xhp + + + +spreadsheets; inserting cells +cells; inserting +inserting; cells + + + + + Insert Cells +Opens the Insert Cells dialog, in which you can insert new cells according to the options that you specify. + You can delete cells by choosing Edit - Delete Cells. +
+ +
+Selection +This area contains the options available for inserting cells into a sheet. The cell quantity and position is defined by selecting a cell range in the sheet beforehand. + + +Shift cells down +Moves the contents of the selected range downward when cells are inserted. + + + + +Shift cells right +Moves the contents of the selected range to the right when cells are inserted. + + +Entire row +Inserts an entire row. The position of the row is determined by the selection on the sheet. + The number of rows inserted depends on how many rows are selected. The contents of the original rows are moved downward. + +Entire column +Inserts an entire column. The number of columns to be inserted is determined by the selected number of columns. + The contents of the original columns are shifted to the right. + + + diff --git a/helpcontent2/source/text/scalc/01/04030000.xhp b/helpcontent2/source/text/scalc/01/04030000.xhp new file mode 100644 index 000000000..367ad26d4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04030000.xhp @@ -0,0 +1,58 @@ + + + + + + + Insert Rows + /text/scalc/01/04030000.xhp + + + + + + + + spreadsheets; inserting rows + rows; inserting + inserting; rows + + + + +Insert Rows +Insert rows above or below the active cell. The number of rows inserted corresponds to the number of rows selected. If no row is selected, one row is inserted. The existing rows are moved downward. + +Rows Above +Inserts a new row above the active cell. + +
+ +
+ + +Rows Below +Inserts a new row below the active cell. + +
+ +
+ + + diff --git a/helpcontent2/source/text/scalc/01/04040000.xhp b/helpcontent2/source/text/scalc/01/04040000.xhp new file mode 100644 index 000000000..f51d1311f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04040000.xhp @@ -0,0 +1,58 @@ + + + + + + + Insert Columns + /text/scalc/01/04040000.xhp + + + + + + + + spreadsheets; inserting columns + inserting; columns + columns; inserting + + + + +Insert Columns +Inserts columns to the left or to the right of the active cell. The number of columns inserted corresponds to the number of columns selected. If no column is selected, one column is inserted. The existing columns are moved to the right. + +Columns Before +Inserts a new column before the active cell. + +
+ +
+ + +Columns After +Inserts a new column after the active cell. + +
+ +
+ + + diff --git a/helpcontent2/source/text/scalc/01/04050000.xhp b/helpcontent2/source/text/scalc/01/04050000.xhp new file mode 100644 index 000000000..7f4eab60f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04050000.xhp @@ -0,0 +1,74 @@ + + + + + + + + +Insert Sheet +/text/scalc/01/04050000.xhp + + + +sheets;creating + + + + +Insert Sheet +Defines the options to be used to insert a new sheet. You can create a new sheet, or insert an existing sheet from a file. + +
+ +
+Position +Specifies where the new sheet is to be inserted into your document. + +Before current sheet +Inserts a new sheet directly before the current sheet. + +After current sheet +Inserts a new sheet directly after the current sheet. +Sheet +Specifies whether a new sheet or an existing sheet is inserted into the document. + +New sheet +Creates a new sheet. Enter a sheet name in the Name field. Allowed characters are letters, numbers, spaces, and the underline character. + +No. of sheets +Specifies the number of sheets to be created. + +Name +Specifies the name of the new sheet. + + +From File +Inserts a sheet from an existing file into the current document. + +Browse +Opens a dialog for selecting a file. + +Available Sheets +If you selected a file by using the Browse button, the sheets contained in it are displayed in the list box. The file path is displayed below this box. Select the sheet to be inserted from the list box. + +Link +Select to insert the sheet as a link instead as a copy. The links can be updated to show the current contents. + + diff --git a/helpcontent2/source/text/scalc/01/04050100.xhp b/helpcontent2/source/text/scalc/01/04050100.xhp new file mode 100644 index 000000000..0d120c768 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04050100.xhp @@ -0,0 +1,49 @@ + + + + + + + + + + +Sheet from file +/text/scalc/01/04050100.xhp + + + +
+ +Sheet from file +Inserts a sheet from a different spreadsheet file. +
+
+ +
+ + +Use the File - Open dialog to locate the spreadsheet. + + +In the Insert Sheet dialog, select the sheet that you want to insert. + + + + diff --git a/helpcontent2/source/text/scalc/01/04060000.xhp b/helpcontent2/source/text/scalc/01/04060000.xhp new file mode 100644 index 000000000..4fad66a05 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060000.xhp @@ -0,0 +1,110 @@ + + + + + + + + +Function Wizard +/text/scalc/01/04060000.xhp + + + + +inserting functions; Function Wizard +functions;Function Wizard +wizards; functions + + + + + +
+

Function

+Opens the Function Wizard, which helps you to interactively create formulas. +
+Before you start the Wizard, select a cell or a range of cells from the current sheet, in order to determine the position at which the formula will be inserted. +
+ +
+You can download the complete ODFF (OpenDocument Format Formula) specification from the OASIS web site. +The Function Wizard has two tabs: Functions is used to create formulas, and Structure is used to check the formula build. +

Functions Tab

+ +

Search

+Search for a part of the function name. + +

Category

+Lists all the categories to which the different functions are assigned. Select a category to view the appropriate functions in the list field below. Select "All" to view all functions in alphabetical order, irrespective of category. "Last Used" lists the functions you have most recently used. + +You can browse the full List of Categories and Functions. + +

Function

+Displays the functions found under the selected category. Double-click to select a function. A single-click displays a short function description. + +

Array

+Specifies that the selected function is inserted into the selected cell range as an array formula. Array formulas operate on multiple cells. Each cell in the array contains the formula, not as a copy but as a common formula shared by all matrix cells. +The Array option is identical to the CommandCtrl+Shift+Enter command, which is used to enter and confirm formulas in the sheet. The formula is inserted as a matrix formula indicated by two braces: { }. +The maximum size of an array range is 128 by 128 cells. +

Argument Input Fields

+When you double-click a function, the argument input field(s) appear on the right side of the dialog. To select a cell reference as an argument, click directly into the cell, or drag across the required range on the sheet while holding down the mouse button. You can also enter numerical and other values or references directly into the corresponding fields in the dialog. When using date entries, make sure you use the correct format. Click OK to insert the result into the spreadsheet. + + +

Function Result

+As soon you enter arguments in the function, the result is calculated. This preview informs you if the calculation can be carried out with the arguments given. If the arguments result in an error, the corresponding error code is displayed. +The required arguments are indicated by names in bold print. + + + + +

f(x) (depending on the selected function)

+Allows you to access a subordinate level of the Function Wizard in order to nest another function within the function, instead of a value or reference. +

Argument/Parameter/Cell Reference (depending on the selected function)

+The number of visible text fields depends on the function. Enter arguments either directly into the argument fields or by clicking a cell in the table. + +

Result

+Displays the calculation result or an error message. + +

Formula

+Displays the created formula. Type your entries directly, or create the formula using the wizard. + +

Back

+Moves the focus back through the formula components, marking them as it does so. +To select a single function from a complex formula consisting of several functions, double-click the function in the formula window. + +

Next

+Moves forward through the formula components in the formula window. This button can also be used to assign functions to the formula. If you select a function and click the Next button, the selection appears in the formula window. +Double-click a function in the selection window to transfer it to the formula window. + +

OK

+Ends the Function Wizard, and transfers the formula to the selected cells. + +

Cancel

+Closes the dialog without implementing the formula. +

Structure tab

+On this page, you can view the structure of the function. +If you start the Function Wizard while the cell cursor is positioned in a cell that already contains a function, the Structure tab is opened and shows the composition of the current formula. + + +

Structure

+Displays a hierarchical representation of the current function. You can hide or show the arguments by a click on the plus or minus sign in front. +Blue dots denote correctly entered arguments. Red dots indicate incorrect data types. For example: if the SUM function has one argument entered as text, this is highlighted in red as SUM only permits number entries. + + diff --git a/helpcontent2/source/text/scalc/01/04060100.xhp b/helpcontent2/source/text/scalc/01/04060100.xhp new file mode 100644 index 000000000..d5aa76ba5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060100.xhp @@ -0,0 +1,60 @@ + + + + + + + Functions by Category + /text/scalc/01/04060100.xhp + + + +functions;listed by category + categories of functions + list of functions +MW deleted "Calc functions" +

Functions by Category

+ This section describes the functions of $[officename] Calc. The various functions are divided into categories in the Function Wizard. +

Database

+ + Date & Time + + Financial + + Information + +

Logical

+ + Mathematical + + Array + + Statistical + + Spreadsheet + + Text + + Add-in + +
+ Operators +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060101.xhp b/helpcontent2/source/text/scalc/01/04060101.xhp new file mode 100644 index 000000000..543c76bed --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060101.xhp @@ -0,0 +1,1022 @@ + + + + + + + + + Database Functions + /text/scalc/01/04060101.xhp + + + + + Function Wizard; databases + functions; database functions + databases; functions in $[officename] Calc + + +

Database Functions

+

Overview

+ The twelve functions in the Database category help you to analyze a simple database that occupies a rectangular spreadsheet area comprising columns and rows, with the data organized as one row for each record. The header cell of each column displays the name of the column and that name usually reflects the contents of each cell in that column. + The functions in the Database category take three arguments as follows: + + + Database. The cell range of the database. + + + DatabaseField. The column containing the data to be used in the function’s calculations. + + + SearchCriteria. The cell range of a separate area of the spreadsheet containing search criteria. + + + These arguments are described more fully below. + All functions have the same outline concept of operation. The first logical step is to use the specified SearchCriteria to identify the subset of records in the Database that are to be used during subsequent calculations. The second step is to extract the data values and perform the calculations associated with the specific function (average, sum, product, and so on). The values processed are those in the DatabaseField column of the selected records. + Calc treats dates and logical values (TRUE and FALSE) as numeric when calculating with these functions. + +

Database Function Arguments

+ The following argument definitions apply for all functions in the Database category: + + + Database argument + Database specifies the range of cells occupied by the database table. The first row of the range contains the field names, and subsequent rows are records with corresponding field values. + One way of defining the range of cells is to enter the cell reference for the upper left-hand cell, followed by a colon (:), and then the lower right-hand cell reference. An example might be A1:E10. + The Database argument may also be specified by passing the name of a named range or database range. Using a meaningful name to define the cell range can enhance formula readability and document maintenance. If the name does not match the name of a defined range, Calc reports a #NAME? error. + Other errors that might be reported as a result of an invalid Database argument are #VALUE! and Err:504 (error in parameter list). + + + DatabaseField argument + DatabaseField specifies the column which the function will use for its calculations after the search criteria have been applied and the data rows have been selected. It is not related to the search criteria. + Specify the DatabaseField argument in any of the following ways: +
Dummy section inserted to nest unordered list within ordered list. + + + By entering a reference to a header cell within the Database area. Alternatively, if the cell has been given a meaningful name as a named range or database range, enter that name. If the name does not match the name of a defined range, Calc reports a #NAME? error. If the name is valid but does not correspond to one cell only, Calc reports Err:504 (error in parameter list). + + + By entering a number to specify the column within the Database area, starting with 1. For example, if a Database occupied the cell range D6:H123, then enter 3 to indicate the header cell at F6. Calc expects an integer value that lies between 1 and the number of columns defined within Database and ignores any digits after a decimal point. If the value is less than 1, Calc reports Err:504 (error in parameter list). If the value is greater than the number of columns in Database, Calc reports a #VALUE! error. + + + By entering the literal column header name from the first row of the Database range, placing quotation marks around the header name. For example, “Distance to School”. If the string does not match one of the Database area’s column headings, Calc reports Err:504 (error in parameter list). You can also provide a reference to an arbitrary cell (not within the Database and SearchCriteria areas) that contains the required string. + + +
+ The DatabaseField argument is optional for the DCOUNT and DCOUNTA functions but it is required for the other ten Database functions. + + + SearchCriteria argument + SearchCriteria specifies the range of cells containing search criteria. Like Database, its first row is also field names, and subsequent rows are conditions for related fields. The Database and SearchCriteria areas need not be adjacent, or even on the same sheet. + One way of defining the range of cells is to enter the cell reference for the upper left-hand cell, followed by a colon (:), and then the lower right-hand cell reference. For example, A13:B14. The cell range may also be specified by passing the name of a defined named range or database range. If the name does not match the name of a defined range, Calc reports a #NAME? error. + Err:504 (error in parameter list) may also be reported as a result of an invalid SearchCriteria argument. + The contents of the SearchCriteria area are described in more detail in the next section. + + + + +

Defining Search Criteria

+ The number of columns occupied by the SearchCriteria area need not be the same as the width of the Database area. All headings that appear in the first row of SearchCriteria must be identical to headings in the first row of Database. However, not all headings in Database need appear in the first row of SearchCriteria, while a heading in Database can appear multiple times in the first row of SearchCriteria. + Search criteria are entered into the cells of the second and subsequent rows of the SearchCriteria area, below the row containing headings. Blank cells within the SearchCriteria area are ignored. + Create criteria in the cells of the SearchCriteria area using the comparison operators <, <=, =, <>, >=, and >. = is assumed if a cell is not empty but does not start with a comparison operator. + If you write several criteria in one row, they are connected by AND. If you write several criteria in different rows, they are connected by OR. + Criteria can be created using wildcards, providing that wildcards have been enabled via the Enable wildcards in formulas option on the %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Calculate dialog. When interoperability with Microsoft Excel is important for your spreadsheet, this option should be enabled. + Even more powerful criteria can be created using regular expressions, providing that regular expressions have been enabled via the Enable regular expressions in formulas option on the %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Calculate dialog. + + + + Another setting that affects how the search criteria are handled is the Search criteria = and <> must apply to whole cells option on the %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Calculate dialog. This option controls whether the search criteria you set for the Database functions must match the whole cell exactly. When interoperability with Microsoft Excel is important for your spreadsheet, this option should be enabled. + +

Examples of Database Function Use

+ The following table provides an example database table that is utilized to demonstrate how to use the functions in the Database category. The cell range A1:E10 contains fictitious information about the guests invited to Joe's birthday party. The following information is given for each guest - name, school grade, age in years, distance to school in meters, and weight in kilograms. + + + + + + A + + + B + + + C + + + D + + + E + + + + + 1 + + + Name + + + Grade + + + Age + + + Distance + + + Weight + + + + + 2 + + + Andy + + + 3 + + + 9 + + + 150 + + + 40 + + + + + 3 + + + Betty + + + 4 + + + 10 + + + 1000 + + + 42 + + + + + 4 + + + Charles + + + 3 + + + 10 + + + 300 + + + 51 + + + + + 5 + + + Daniel + + + 5 + + + 11 + + + 1200 + + + 48 + + + + + 6 + + + Eva + + + 2 + + + 8 + + + 650 + + + 33 + + + + + 7 + + + Frank + + + 2 + + + 7 + + + 300 + + + 42 + + + + + 8 + + + Greta + + + 1 + + + 7 + + + 200 + + + 36 + + + + + 9 + + + Harry + + + 3 + + + 9 + + + 1200 + + + 44 + + + + + 10 + + + Irene + + + 2 + + + 8 + + + 1000 + + + 42 + + + + + 11 + + + + + + + + + + + + +
+ + The following six examples use the database table above, combined with different search criteria areas. + +

Example 1

+ + + + + + A + + + B + + + C + + + D + + + E + + + + + 12 + + + Name + + + Grade + + + Age + + + Distance + + + Weight + + + + + 13 + + + + + + + + + >600 + + + + + + + 14 + + + + + + + + + + + + +
+ + As in this simple example, it is sometimes desirable (but not essential) to place the search criteria area directly under the database table, with the columns of the two areas vertically aligned. Blank entries in the search criteria area are ignored. With the above example database table and this search criteria area, insert the formula =DCOUNT(A1:E10;;A12:E14) into an empty cell elsewhere in the sheet to count how many of Joe’s guests travel further than 600 meters to school. The value 5 is returned (counting Betty, Daniel, Eva, Harry, and Irene). + Note also that the formula =DCOUNT(A1:E10;;D12:D13) returns exactly the same value, demonstrating that it is only necessary for the search criteria area to contain relevant column headings. +

Example 2

+ + + + + + +    A    + + +    B    + + +    C    + + +    D    + + +    E    + + + + + 12 + + + + + Age + + + Grade + + + + + + + + + 13 + + + + + >7 + + + 2 + + + + + + + + + 14 + + + + + + + + + + + + +
+ + In this example the search criteria area contains only two headings and these are not vertically aligned with the corresponding headings in the example database table. Since there are two conditions in the same row, these are connected by AND. With the above example database table and this search criteria area, insert the formula =DCOUNT(A1:E10;;B12:C13) into an empty cell elsewhere in the sheet to count how many of Joe’s guests are in grade 2 and greater than 7 years old. The value 2 is returned (counting Eva and Irene). + +

Example 3

+ + + + + + +    A    + + +    B    + + +    C    + + +    D    + + +    E    + + + + + 12 + + + + + Age + + + + + + + + + + + 13 + + + + + 9 + + + + + + + + + + + 14 + + + + + 10 + + + + + + + + +
+ + In this example the search criteria area contains only one heading. Since there are two conditions in consecutive rows, these are connected by OR. With the above example database table and this search criteria area, insert the formula =DCOUNT(A1:E10;;B12:B14) into an empty cell elsewhere in the sheet to count how many of Joe’s guests are either 9 or 10 years old. The value 4 is returned (counting Andy, Betty, Charles, and Harry). + +

Example 4

+ + + + + +    A    + + +    B    + + +    C    + + +    D    + + +    E    + + + + + 12 + + + + + Age + + + Age + + + + + + + + + 13 + + + + + >=8 + + + <=10 + + + + + + + + + 14 + + + + + + + + + + + + +
+ + In this example the search criteria area contains two occurrences of the same heading. Since there are two conditions in the same row, these are connected by AND. With the above example database table and this search criteria area, insert the formula =DCOUNT(A1:E10;;B12:C13) into an empty cell elsewhere in the sheet to count how many of Joe’s guests are aged between 8 and 10 (inclusive). The value 6 is returned (counting Andy, Betty, Charles, Eva, Harry, and Irene). + +

Example 5

+ + + + + +    A    + + +    B    + + +    C    + + +    D    + + +    E    + + + + + 12 + + + Name + + + + + + + + + + + + + 13 + + + F* + + + + + + + + + + + + + 14 + + + + + + + + + + + + +
+ + This simple example shows the use of wildcards. For this example to work as intended, select to enable wildcards at %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Calculate. With the above example database table and this search criteria area, insert the formula =DCOUNT(A1:E10;;A12:A13) into an empty cell elsewhere in the sheet to count how many of Joe’s guests have names that begin with the letter “F”. The value 1 is returned (counting Frank). + + +

Example 6

+ + + + + +    A    + + +    B    + + +    C    + + +    D    + + +    E    + + + + + 12 + + + Name + + + + + + + + + + + + + 13 + + + [ABC].* + + + + + + + + + + + + + 14 + + + + + + + + + + + + +
+ + This simple example shows the use of regular expressions. For this example to work as intended, select to enable regular expressions at %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Calculate. With the above example database table and this search criteria area, insert the formula =DCOUNT(A1:E10;;A12:A13) into an empty cell elsewhere in the sheet to count how many of Joe’s guests have names that begin with the letters “A”, “B”, or “C”. The value 3 is returned (counting Andy, Betty, and Charles). + + +
+ +DCOUNT function +counting rows;with numeric values +mw added "counting rows;" + +

DCOUNT

+ DCOUNT counts the number of cells (fields) of the specified column that contain numeric values, for all rows (database records) that match the specified search criteria. However, if no column is specified, DCOUNT returns the count of all records that match the specified search criteria irrespective of their contents. + + + DCOUNT(Database; [DatabaseField]; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">600" (this search criterion will match records in the database table that have a value greater than 600 in the Distance column). + Insert the formula =DCOUNT(A1:E10;; A12:E13) into an empty cell elsewhere in the sheet to calculate how many of Joe’s party guests travel further than 600 meters to school. The value 5 is returned. + The same result is obtained if you use the formula =DCOUNT(A1:E10; "Distance"; A12:E13), because all entries in the Distance column are numeric. However, if you use the formula =DCOUNT(A1:E10; "Name"; A12:E13), the value 0 is returned because all entries in the Name column are non-numeric. +
+ +
+ +DCOUNTA function +records;counting in Calc databases +counting rows;with numeric or alphanumeric values +mw added "records;" and "counting rows;" + +

DCOUNTA

+ DCOUNTA counts the number of cells (fields) of the specified column that are not blank, for all rows (database records) that match the specified search criteria. Blank cells of the specified column are not counted. However, if no column is specified, DCOUNTA returns the count of all records that match the specified search criteria irrespective of their contents. + + + DCOUNTA(Database; [DatabaseField]; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">600" (this search criterion will match records in the database table that have a value greater than 600 in the Distance column). + Insert the formula =DCOUNTA(A1:E10;; A12:E13) into an empty cell elsewhere in the sheet to calculate how many of Joe’s party guests travel further than 600 meters to school. The value 5 is returned. + The same result is obtained if you use the formula =DCOUNTA(A1:E10; "Distance"; A12:E13) or the formula =DCOUNTA(A1:E10; "Name"; A12:E13). The latter case reflects that in contrast to DCOUNT, DCOUNTA counts both numeric and alphanumeric values in the column indicated by the DatabaseField argument. +
+ +
+ +DGET function +cell contents;searching in Calc databases +searching;cell contents in Calc databases +mw added "cell contents;" and "searching;" + +

DGET

+ DGET returns the contents of the cell (field) of the specified column, for the single row (database record) that matches the specified search criteria. + Calc reports Err:502 (invalid argument) if multiple matches are found, or a #VALUE! error (wrong data type) if no matches are found. A #VALUE! error is also reported if a single match is found but the relevant cell is empty. + + + DGET(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell C13 which should contain "11" (this search criterion will match records in the database table that have a value of 11 in the Age column). + Insert the formula =DGET(A1:E10; "Name"; A12:E13) into an empty cell elsewhere in the sheet to find the name of Joe’s party guest who is age 11. The name Daniel is returned. + If you change the value in cell C13 to “10”, then the formula =DGET(A1:E10; "Name"; A12:E13) returns an invalid argument error (Err:502). The reflects that multiple records match the specified criterion (both Betty and Charles are age 10). +
+ +
+ +DMAX function +maximum values in Calc databases +searching;maximum values in columns +mw added "maximum..." and "searching;" + +

DMAX

+ DMAX calculates the maximum value across the cells (fields) of the specified column that contain numeric values, for all rows (database records) that match the specified search criteria. Blank cells or cells containing non-numeric characters are not included. + Returns 0 if no matches are found, or if there are no non-zero numeric values in the cells of the specified column for the matching records. + + + DMAX(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DMAX(A1:E10; "Distance"; A12:E13) into an empty cell elsewhere in the sheet to find the maximum distance in meters that any of Joe’s party guests travel to school. The value 1200 is returned. +
+ +
+ +DMIN function +minimum values in Calc databases +searching;minimum values in columns +mw added "minimum..." and "searching;" + +

DMIN

+ DMIN calculates the minimum value across the cells (fields) of the specified column that contain numeric values, for all rows (database records) that match the specified search criteria. Blank cells or cells containing non-numeric characters are not included. + Returns 0 if no matches are found, or if there are no non-zero numeric values in the cells of the specified column for the matching records. + + + DMIN(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DMIN(A1:E10; "Distance"; A12:E13) into an empty cell elsewhere in the sheet to find the minimum distance in meters that any of Joe’s party guests travel to school. The value 150 is returned. +
+ +
+ +DAVERAGE function +averages; in Calc databases +calculating;averages in Calc databases +mw added "averages;..." and "calculating;" + +

DAVERAGE

+ DAVERAGE calculates the average of the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria. Non-numeric values in those cells are ignored. + Returns a #DIV/0! error if no records match the specified search criteria, or if there are no numeric values in the cells of the specified column for the matching records. + + + DAVERAGE(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DAVERAGE(A1:E10; "Distance"; A12:E13) into an empty cell elsewhere in the sheet to calculate the average distance in meters travelled to school by Joe’s party guests. The value 666.67 is returned. +
+ +
+ +DPRODUCT function +multiplying;cell contents in Calc databases +mw added "multiplying..." + +

DPRODUCT

+ DPRODUCT calculates the product of all numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria. Blank cells or cells containing non-numeric characters are not included. + Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records. + + + DPRODUCT(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell C13 which should contain ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DPRODUCT(A1:E10; "Age"; A12:E13) into an empty cell elsewhere in the sheet to calculate the product of the ages in years of Joe’s party guests. The value 279417600 is returned. +
+ +
+ +DSTDEV function +standard deviations in databases;based on a sample +mw added "standard deviations...;" + +

DSTDEV

+ DSTDEV calculates the sample standard deviation based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria. Non-numeric values are ignored. + Returns a #NUM! error if exactly one record matches the specified search criteria, or if there is only one numeric value in the cells of the specified column for the matching records. + Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records. + + + DSTDEV(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:D13 are blank and that cell E13 contains ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DSTDEV(A1:E10; "Weight"; A12:E13) into an empty cell elsewhere in the sheet to calculate the sample standard deviation of the weights in kg of Joe’s party guests. The value 5.5 is returned. +
+ +
+ +DSTDEVP function +standard deviations in databases;based on populations +mw added "standard deviations...;" + +

DSTDEVP

+ DSTDEVP calculates the population standard deviation based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria. Non-numeric values are ignored. + Returns a #NUM! error if no records match the specified search criteria, or if there are no numeric values in the cells of the specified column for the matching records. + + + DSTDEVP(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:D13 are blank and that cell E13 contains ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DSTDEVP(A1:E10; "Weight"; A12:E13) into an empty cell elsewhere in the sheet to calculate the population standard deviation of the weights in kg of Joe’s party guests. The value 5.18545 is returned. +
+ +
+ +DSUM function +calculating;sums in Calc databases +sums;cells in Calc databases +mw added "calculating;" and "sums;" + +

DSUM

+ DSUM calculates the sum of all numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria. Blank cells or cells containing non-numeric characters are not included. + Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records. + + + DSUM(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DSUM(A1:E10; "Distance"; A12:E13) into an empty cell elsewhere in the sheet to find the total distance in meters that all of Joe’s party guests travel to school. The value 6000 is returned. +
+ +
+ +DVAR function +variances;based on samples +mw added "variances;" + +

DVAR

+ DVAR calculates the sample variance based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria. Non-numeric values are ignored. + Returns a #NUM! error if exactly one record matches the specified search criteria, or if there is only one numeric value in the cells of the specified column for the matching records. + Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records. + + + DVAR(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DVAR(A1:E10; "Distance"; A12:E13) into an empty cell elsewhere in the sheet to find the sample variance of the distances in meters that Joe’s party guests travel to school. The value 193125 is returned. +
+ +
+ +DVARP function +variances;based on populations +mw added "variances;" + +

DVARP

+ DVARP calculates the population variation based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria. Non-numeric values are ignored. + Returns a #NUM! error if no records match the specified search criteria, or if there are no numeric values in the cells of the specified column for the matching records. + + + DVARP(Database; DatabaseField; SearchCriteria) + + + The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table). + Insert the formula =DVARP(A1:E10; "Distance"; A12:E13) into an empty cell elsewhere in the sheet to find the population variance of the distances in meters that Joe’s party guests travel to school. The value 171666.67 is returned. +
+ + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060102.xhp b/helpcontent2/source/text/scalc/01/04060102.xhp new file mode 100644 index 000000000..2e1fd1799 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060102.xhp @@ -0,0 +1,139 @@ + + + + + + + Date & Time Functions + /text/scalc/01/04060102.xhp + + + + + + date and time functions + functions; date & time + Function Wizard; date & time + +

Date & Time Functions

+These spreadsheet functions are used for inserting and editing dates and times. + +
+ +
+ +
+The functions whose names end with _ADD or _EXCEL2003 return the same results as the corresponding Microsoft Excel 2003 functions without the suffix. Use the functions without suffix to get results based on international standards. +
+$[officename] internally handles a date/time value as a numerical value. If you assign the numbering format "Number" to a date or time value, it is converted to a number. For example, 01/01/2000 12:00 PM, converts to 36526.5. The value preceding the decimal point corresponds to the date; the value following the decimal point corresponds to the time. If you do not want to see this type of numerical date or time representation, change the number format (date or time) accordingly. To do this, select the cell containing the date or time value, call its context menu and select Format Cells. The Numbers tab page contains the functions for defining the number format. + +
+

Date base for day zero

+Dates are calculated as offsets from a starting day zero. You can set the day zero to be one of the following: + + + + + Date base + + + Use + + + + + '12/30/1899' + + + (default) + + + + + '01/01/1900' + + + (used in former StarCalc 1.0) + + + + + '01/01/1904' + + + (used in Apple software) + + +
+
+Choose %PRODUCTNAME - Preferences +Tools - Options - %PRODUCTNAME Calc - Calculate to select the date base. +When you copy and paste cells containing date values between different spreadsheets, both spreadsheet documents must be set to the same date base. If date bases differ, the displayed date values will change! + +

Two digits years

+In %PRODUCTNAME - Preferences +Tools - Options - $[officename] - General you find the area Year (two digits). This sets the period for which two-digit information applies. Note that changes made here have an effect on some of the following functions. +
+When entering dates as part of formulas, slashes or dashes used as date separators are interpreted as arithmetic operators. Therefore, dates entered in this format are not recognized as dates and result in erroneous calculations. To keep dates from being interpreted as parts of formulas use the DATE function, for example, DATE(1954;7;20), or place the date in quotation marks and use the ISO 8601 notation, for example, "1954-07-20". Avoid using locale dependent date formats such as "07/20/54", the calculation may produce errors if the document is loaded under different locale settings. +
+
+ Unambiguous conversion is possible for ISO 8601 dates and times in their extended formats with separators. If a #VALUE! error occurs, then unselect Generate #VALUE! error in %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Formula, button Details... in section "Detailed Calculation Settings", Conversion from text to number list box. +
+ +Time zone information is not used in Date and Time functions and cells. + +

Functions

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060103.xhp b/helpcontent2/source/text/scalc/01/04060103.xhp new file mode 100644 index 000000000..1b14bdc26 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060103.xhp @@ -0,0 +1,737 @@ + + + + + + + Financial Functions Part One + /text/scalc/01/04060103.xhp + + + +financial functions + functions; financial functions + Function Wizard; financial + amortizations, see also depreciations +mw added one entry +

Financial Functions Part One

+ This category contains the mathematical finance functions of %PRODUCTNAME Calc. + + +
+AMORDEGRC function + depreciations;degressive amortizations +mw added one entry + +

AMORDEGRC

+ Calculates the amount of depreciation for a settlement period as degressive amortization. Unlike AMORLINC, a depreciation coefficient that is independent of the depreciable life is used here. + + AMORDEGRC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate [; Basis]) + + Cost is the acquisition costs. + + DatePurchased is the date of acquisition. + + FirstPeriod is the end date of the first settlement period. + + Salvage is the salvage value of the capital asset at the end of the depreciable life. + + Period is the settlement period to be considered. + + Rate is the rate of depreciation. + + + An asset was acquired on 2020-02-01 at a cost of 2000 currency units. The end date of the first settlement period was 2020-12-31. The salvage value of the asset at the end of its depreciable life will be 10 currency units. The rate of depreciation is 0.1 (10%) and the year is calculated using the US method (Basis 0). Assuming degressive depreciation, what is the amount of depreciation in the fourth depreciation period? + + =AMORDEGRC(2000; "2020-02-01"; "2020-12-31"; 10; 4; 0.1; 0) returns a depreciation amount of 163 currency units. +
+ Beware that Basis 2 is not supported by Microsoft Excel. Hence, if you use Basis 2 and export your document to XLSX format, it will return an error when opened in Excel. +
+
+
+AMORLINC function + depreciations;linear amortizations +mw added "depreciations;..." + +

AMORLINC

+ Calculates the amount of depreciation for a settlement period as linear amortization. If the capital asset is purchased during the settlement period, the proportional amount of depreciation is considered. + + AMORLINC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate [; Basis]) + + Cost means the acquisition costs. + + DatePurchased is the date of acquisition. + + FirstPeriod is the end date of the first settlement period. + + Salvage is the salvage value of the capital asset at the end of the depreciable life. + + Period is the settlement period to be considered. + + Rate is the rate of depreciation. + + + An asset was acquired on 2020-02-01 at a cost of 2000 currency units. The end date of the first settlement period was 2020-12-31. The salvage value of the asset at the end of its depreciable life will be 10 currency units. The rate of depreciation is 0.1 (10%) and the year is calculated using the US method (Basis 0). Assuming linear depreciation, what is the amount of depreciation in the fourth depreciation period? + + =AMORLINC(2000; "2020-02-01"; "2020-12-31"; 10; 4; 0.1; 0) returns a depreciation amount of 200 currency units. + +
+
+ACCRINT function + + +

ACCRINT

+accrued interests;periodic payments +mw changed "accrued interests" +Calculates the accrued interest of a security in the case of periodic payments. + + ACCRINT(Issue; FirstInterest; Settlement; Rate; [Par]; Frequency [; Basis]) + + Issue (required) is the issue date of the security. + + FirstInterest (required) is the first interest date of the security. + + Settlement (required) is the date at which the interest accrued up until then is to be calculated. + + Rate (required) is the annual nominal rate of interest (coupon interest rate) + + Par (optional) is the par value of the security. If omitted, a default value of 1000 is used. + We recommend that you always specify the value that you require for ACCRINT’s Par argument, rather than allowing Calc to apply an arbitrary default. This will make your formula easier to understand and easier to maintain. + + Frequency (required) is the number of interest payments per year (1, 2 or 4). + + + A security is issued on 2001-02-28. First interest is set for 2001-08-31. The settlement date is 2001-05-01. The Rate is 0.1 or 10% and Par is 1000 currency units. Interest is paid half-yearly (frequency is 2). The basis is the US method (0). How much interest has accrued? + + =ACCRINT("2001-02-28";"2001-08-31";"2001-05-01";0.1;1000;2;0) returns 16.94444. +
+
+ACCRINTM function + accrued interests;one-off payments +mw added one index entry + +

ACCRINTM

+ Calculates the accrued interest of a security in the case of one-off payment at the settlement date. + + ACCRINTM(Issue; Settlement; Rate [; Par [; Basis]]) + + Issue (required) is the issue date of the security. + + Settlement (required) is the date at which the interest accrued up until then is to be calculated. + + Rate (required) is the annual nominal rate of interest (coupon interest rate). + + Par (optional) is the par value of the security. If omitted, a default value of 1000 is used. + We recommend that you always specify the value that you require for ACCRINTM’s Par argument, rather than allowing Calc to apply an arbitrary default. This will make your formula easier to understand and easier to maintain. + + + A security is issued on 2001-04-01. The maturity date is set for 2001-06-15. The Rate is 0.1 or 10% and Par is 1000 currency units. The basis of the daily/annual calculation is the daily balance (3). How much interest has accrued? + + =ACCRINTM("2001-04-01";"2001-06-15";0.1;1000;3) returns 20.54795. +
+
+RECEIVED function + amount received for fixed-interest securities +mw added one entry + +

RECEIVED

+ Calculates the amount received that is paid for a fixed-interest security at a given point in time. + + RECEIVED(Settlement; Maturity; Investment; Discount [; Basis]) + + Settlement is the date of purchase of the security. + + Maturity is the date on which the security matures (expires). + + Investment is the purchase sum. + + Discount is the percentage discount on acquisition of the security. + + + Settlement date: February 15 1999, maturity date: May 15 1999, investment sum: 1000 currency units, discount: 5.75 per cent, basis: Daily balance/360 = 2. + The amount received on the maturity date is calculated as follows: + + =RECEIVED("1999-02-15";"1999-05-15";1000;0.0575;2) returns 1014.420266. +
+
+PV function + present values + calculating; present values + + +

PV

+ Returns the present value of an investment resulting from a series of regular payments. + Use this function to calculate the amount of money needed to be invested at a fixed rate today, to receive a specific amount, an annuity, over a specified number of periods. You can also determine how much money is to remain after the elapse of the period. Specify as well if the amount is to be paid out at the beginning or at the end of each period. + Enter these values either as numbers, expressions or references. If, for example, interest is paid annually at 8%, but you want to use month as your period, enter 8%/12 under Rate and %PRODUCTNAME Calc with automatically calculate the correct factor. + + PV(Rate; NPer; Pmt [; FV [; Type]]) + + Rate defines the interest rate per period. + + NPer is the total number of periods (payment period). + + Pmt is the regular payment made per period. + + FV (optional) defines the future value remaining after the final installment has been made. + + Type (optional) denotes due date for payments. Type = 1 means due at the beginning of a period and Type = 0 (default) means due at the end of the period. + + + + + What is the present value of an investment, if 500 currency units are paid out monthly and the annual interest rate is 8%? The payment period is 48 months and 20,000 currency units are to remain at the end of the payment period. + + =PV(8%/12;48;500;20000) = -35,019.37 currency units. Under the named conditions, you must deposit 35,019.37 currency units today, if you want to receive 500 currency units per month for 48 months and have 20,000 currency units left over at the end. Cross-checking shows that 48 x 500 currency units + 20,000 currency units = 44,000 currency units. The difference between this amount and the 35,000 currency units deposited represents the interest paid. + If you enter references instead of these values into the formula, you can calculate any number of "If-then" scenarios. Please note: references to constants must be defined as absolute references. Examples of this type of application are found under the depreciation functions. +
+
+calculating; depreciations + SYD function + depreciations; arithmetic declining + arithmetic declining depreciations + + +

SYD

+ Returns the arithmetic-declining depreciation rate. + Use this function to calculate the depreciation amount for one period of the total depreciation span of an object. Arithmetic declining depreciation reduces the depreciation amount from period to period by a fixed sum. + + SYD(Cost; Salvage; Life; Period) + + Cost is the initial cost of an asset. + + Salvage is the value of an asset after depreciation. + + Life is the period fixing the time span over which an asset is depreciated. + + Period defines the period for which the depreciation is to be calculated. + + A video system initially costing 50,000 currency units is to be depreciated annually for the next 5 years. The salvage value is to be 10,000 currency units. You want to calculate depreciation for the first year. + + =SYD(50000;10000;5;1)=13,333.33 currency units. The depreciation amount for the first year is 13,333.33 currency units. + To have an overview of depreciation rates per period, it is best to define a depreciation table. By entering the different depreciation formulas available in %PRODUCTNAME Calc next to each other, you can see which depreciation form is the most appropriate. Enter the table as follows: + + + + + + + A + + + + + B + + + + + C + + + + + D + + + + + E + + + + + + 1 + + + + Initial Cost + + + + + Salvage Value + + + + + Useful Life + + + + + Time Period + + + + + Deprec. SYD + + + + + + 2 + + + + 50,000 currency units + + + + + 10,000 currency units + + + + + 5 + + + + + 1 + + + + + 13,333.33 currency units + + + + + + 3 + + + + + + + + + + 2 + + + + + 10,666.67 currency units + + + + + + 4 + + + + + + + + + + 3 + + + + + 8,000.00 currency units + + + + + + 5 + + + + + + + + + + 4 + + + + + 5,333.33 currency units + + + + + + 6 + + + + + + + + + + 5 + + + + + 2,666.67 currency units + + + + + + 7 + + + + + + + + + + 6 + + + + + 0.00 currency units + + + + + + 8 + + + + + + + + + + 7 + + + + + + + + 9 + + + + + + + + + + 8 + + + + + + + + 10 + + + + + + + + + + 9 + + + + + + + + 11 + + + + + + + + + + 10 + + + + + + + + 12 + + + + + + + + + + + + + + + 13 + + + + >0 + + + + + + + + + Total + + + + + 40,000.00 currency units + + + +
+ + The formula in E2 is as follows: + + =SYD($A$2;$B$2;$C$2;D2) + + This formula is duplicated in column E down to E11 (select E2, then drag down the lower right corner with the mouse). + Cell E13 contains the formula used to check the total of the depreciation amounts. It uses the SUMIF function as the negative values in E8:E11 must not be considered. The condition >0 is contained in cell A13. The formula in E13 is as follows: + + =SUMIF(E2:E11;A13) + + Now view the depreciation for a 10 year period, or at a salvage value of 1 currency unit, or enter a different initial cost, and so on. +
+
+DISC function + allowances + discounts +mw added "discounts" and "allowances" + +

DISC

+ Calculates the allowance (discount) of a security as a percentage. + + DISC(Settlement; Maturity; Price; Redemption [; Basis]) + + Settlement is the date of purchase of the security. + + Maturity is the date on which the security matures (expires). + + Price is the price of the security per 100 currency units of par value. + + Redemption is the redemption value of the security per 100 currency units of par value. + + + A security is purchased on 2001-01-25; the maturity date is 2001-11-15. The price (purchase price) is 97, the redemption value is 100. Using daily balance calculation (basis 3) how high is the settlement (discount)? + + =DISC("2001-01-25";"2001-11-15";97;100;3) returns about 0.0372 or 3.72 per cent. +
+
+DURATION function + durations;fixed interest securities +mw added two entries + +

DURATION

+ Calculates the duration of a fixed interest security in years. + + DURATION(Settlement; Maturity; Coupon; Yield; Frequency [; Basis]) + + Settlement is the date of purchase of the security. + + Maturity is the date on which the security matures (expires). + + Coupon is the annual coupon interest rate (nominal rate of interest) + + Yield is the annual yield of the security. + + Frequency is the number of interest payments per year (1, 2 or 4). + + + A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The Coupon rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how long is the duration? + =DURATION("2001-01-01";"2006-01-01";0.08;0.09;2;3) returns 4.2 years. +
+
+annual net interest rates + calculating; annual net interest rates + net annual interest rates + EFFECT function +mw added one entry + +

EFFECT

+ Returns the net annual interest rate for a nominal interest rate. + Nominal interest refers to the amount of interest due at the end of a calculation period. Effective interest increases with the number of payments made. In other words, interest is often paid in installments (for example, monthly or quarterly) before the end of the calculation period. + + EFFECT(Nom; P) + + Nom is the nominal interest. + + P is the number of interest payment periods per year. + + If the annual nominal interest rate is 9.75% and four interest calculation periods are defined, what is the actual interest rate (effective rate)? + + =EFFECT(9.75%;4) = 10.11% The annual effective rate is therefore 10.11%. +
+
+effective interest rates + EFFECT_ADD function +mw changed "effective rates" + +

EFFECT_ADD

+ Calculates the effective annual rate of interest on the basis of the nominal interest rate and the number of interest payments per annum. + + + EFFECT_ADD(NominalRate; NPerY) + + NominalRate is the annual nominal rate of interest. + + NPerY is the number of interest payments per year. + + What is the effective annual rate of interest for a 5.25% nominal rate and quarterly payment. + + =EFFECT_ADD(0.0525;4) returns 0.053543 or 5.3543%. +
+
+calculating; arithmetic-degressive depreciations + arithmetic-degressive depreciations + depreciations;arithmetic-degressive + DDB function +mw corrected two typos and added "depreciations;..." + +

DDB

+ Returns the depreciation of an asset for a specified period using the arithmetic-declining method. + Use this form of depreciation if you require a higher initial depreciation value as opposed to linear depreciation. The depreciation value gets less with each period and is usually used for assets whose value loss is higher shortly after purchase (for example, vehicles, computers). Please note that the book value will never reach zero under this calculation type. + + DDB(Cost; Salvage; Life; Period [; Factor]) + + Cost fixes the initial cost of an asset. + + Salvage fixes the value of an asset at the end of its life. + + Life is the number of periods (for example, years or months) defining how long the asset is to be used. + + Period states the period for which the value is to be calculated. + + Factor (optional) is the factor by which depreciation decreases. If a value is not entered, the default is factor 2. + + A computer system with an initial cost of 75,000 currency units is to be depreciated monthly over 5 years. The value at the end of the depreciation is to be 1 currency unit. The factor is 2. + + =DDB(75000;1;60;12;2) = 1,721.81 currency units. Therefore, the double-declining depreciation in the twelfth month after purchase is 1,721.81 currency units. +
+
+calculating; geometric-degressive depreciations + geometric-degressive depreciations + depreciations;geometric-degressive + DB function +mw added "depreciations;.." + +

DB

+ Returns the depreciation of an asset for a specified period using the fixed-declining balance method. + This form of depreciation is used if you want to get a higher depreciation value at the beginning of the depreciation (as opposed to linear depreciation). The depreciation value is reduced with every depreciation period by the depreciation already deducted from the initial cost. + + DB(Cost; Salvage; Life; Period [; Month]) + + Cost is the initial cost of an asset. + + Salvage is the value of an asset at the end of the depreciation. + + Life defines the period over which an asset is depreciated. + + Period is the length of each period. The length must be entered in the same date unit as the depreciation period. + + Month (optional) denotes the number of months for the first year of depreciation. If an entry is not defined, 12 is used as the default. + + A computer system with an initial cost of 25,000 currency units is to be depreciated over a three-year period. The salvage value is to be 1,000 currency units. The first period of depreciation comprises 6 months. What is the fixed-declining balance depreciation of the computer system in the second period, which is a full year starting from the end of the first six-month period? + + =DB(25000; 1000; 3; 2; 6) returns 11,037.95 currency units. +
+
+IRR function + calculating;internal rates of return, regular payments + internal rates of return;regular payments + + +

IRR

+ Calculates the internal rate of return for an investment. The values represent cash flow values at regular intervals, at least one value must be negative (payments), and at least one value must be positive (income). + If the payments take place at irregular intervals, use the XIRR function. + + IRR(Values [; Guess]) + + Values represents an array containing the values. + + Guess (optional) is the estimated value. An iterative method is used to calculate the internal rate of return. If you can provide only few values, you should provide an initial guess to enable the iteration. + + + Under the assumption that cell contents are A1=-10000, A2=3500, A3=7600 and A4=1000, the formula =IRR(A1:A4) gives a result of 11,33%. + Because of the iterative method used, it is possible for IRR to fail and return Error 523, with "Error: Calculation does not converge" in the status bar. In that case, try another value for Guess. +
+
+calculating; interests for unchanged amortization installments + interests for unchanged amortization installments + ISPMT function + + +

ISPMT

+ Calculates the level of interest for unchanged amortization installments. + + ISPMT(Rate; Period; TotalPeriods; Invest) + + Rate sets the periodic interest rate. + + Period is the number of installments for calculation of interest. + + TotalPeriods is the total number of installment periods. + + Invest is the amount of the investment. + + For a credit amount of 120,000 currency units with a two-year term and monthly installments, at a yearly interest rate of 12% the level of interest after 1.5 years is required. + + =ISPMT(1%;18;24;120000) = -300 currency units. The monthly interest after 1.5 years amounts to 300 currency units. +
+ +Financial Functions Part Two + Financial Functions Part Three + + + diff --git a/helpcontent2/source/text/scalc/01/04060104.xhp b/helpcontent2/source/text/scalc/01/04060104.xhp new file mode 100644 index 000000000..d2b2f0101 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060104.xhp @@ -0,0 +1,742 @@ + + + + + + Information Functions + /text/scalc/01/04060104.xhp + + + + + information functions + Function Wizard; information + functions; information functions + +

Information Functions

+This category contains the Information functions. +
+ +
+The data in the following table serves as the basis for some of the examples in the function descriptions: + + + + + + C + + + D + + + + + 2 + + + x value + + + y value + + + + + 3 + + + -5 + + + -3 + + + + + 4 + + + -2 + + + 0 + + + + + 5 + + + -1 + + + 1 + + + + + 6 + + + 0 + + + 3 + + + + + 7 + + + 2 + + + 4 + + + + + 8 + + + 4 + + + 6 + + + + + 9 + + + 6 + + + 8 + + +
+ +
+ + INFO function + + +

INFO

+Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter. + + +INFO("Type") +The following table lists the values for the text parameter Type and the return values of the INFO function. + + + + Value for "Type"Do not translate the text values in this column below + + + Return value + + + + + "osversion" + + + Always "Windows (32-bit) NT 5.01", for compatibility reasons + + + + + "system" + + + The type of the operating system:
"AIX" for Advanced Interactive Executive IBM computer operating systems
"ANDROID" for Google mobile operating system
"DRAGONFLY" for DragonFly operating system forked from FreeBSD
"EMSCRIPTEN" for browser WebAssembly system
"FREEBSD", "OPENBSD" or "NETBSD" for operating systems based on the Berkeley Software Distribution (BSD)
"HAIKU" for BeOS compatible operating system
"iOS" for Apple mobile operating system
"LINUX" for GNU/Linux based operating systems
"MACOSX" for Apple Mac OS X
"SOLARIS" for Oracle Solaris operating system
"WNT" for Microsoft Windows + + + + + "release" + + + The product release identifier, for example "300m25(Build:9876)" + + + + + "numfile" + + + Always 1, for compatibility reasons + + + + + "recalc" + + + Current formula recalculation mode, either "Automatic" or "Manual" (localized into %PRODUCTNAME language) + + +
+Other spreadsheet applications may accept localized values for the Type parameter, but %PRODUCTNAME Calc will only accept the English values. + +=INFO("release") returns the product release number of the %PRODUCTNAME in use.Do not translate "release" +=INFO(D5) with cell D5 containing a text string system returns the operation system type.Do not translate the hlp_literal system +
+
+ + CURRENT function + + +

CURRENT

+This function returns the result to date of evaluating the formula of which it is a part (in other words the result as far as that evaluation has got). Its main use is together with the STYLE() function to apply selected styles to a cell depending on the cell contents. + +CURRENT() + +=1+2+CURRENT() +The example returns 6. The formula is calculated from left to right as: 1 + 2 equals 3, giving the result to date when CURRENT() is encountered; CURRENT() therefore yields 3, which is added to the original 3 to give 6. +=A2+B2+STYLE(IF(CURRENT()>10;"Red";"Default")) +The example returns A2 + B2 (STYLE returns 0 here). If this sum is greater than 10, the style Red is applied to the cell. See the STYLE function for more explanation. +="choo"&CURRENT() +The example returns choochoo. + + +ORG.OPENOFFICE.CURRENT +
+
+ + FORMULA function + formula cells;displaying formulas in other cells + displaying;formulas at any position + +mw added "formula cells;" and "displaying;" + +

FORMULA

+Displays the formula of a formula cell as a text string. + + +FORMULA(Reference) +Reference is a reference to a cell containing a formula. +An invalid reference or a reference to a cell with no formula results in the error value #N/A. + +If cell A8 contains the formula =SUM(1;2;3) then +=FORMULA(A8) returns the text =SUM(1;2;3). +
+
+ + ISREF function + references;testing cell contents + cell contents;testing for references + +mw added "references;" and "cell contents;" + +

ISREF

+Tests if the argument is a reference. Returns TRUE if the argument is a reference, returns FALSE otherwise. When given a reference this function does not examine the value being referenced.i82565 + + +ISREF(Value) +Value is the value to be tested, to determine whether it is a reference. + +=ISREF(C5) returns the result TRUE because C5 is a valid reference. +=ISREF("abcdef") returns always FALSE because a text can never be a reference. +=ISREF(4) returns FALSE. +=ISREF(INDIRECT("A6")) returns TRUE, because INDIRECT is a function that returns a reference. +=ISREF(ADDRESS(1; 1; 2;"Sheet2")) returns FALSE, because ADDRESS is a function that returns a text, although it looks like a reference. +
+
+ + ISERR function + error codes;controlling + +mw added "error codes," + +

ISERR

+Tests for error conditions, except the #N/A error value, and returns TRUE or FALSE. + + +ISERR(Value) +Value is any value or expression which is tested to see whether an error value other than #N/A is present. + +=ISERR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error. +=ISERR(C9) where cell C9 contains =NA() returns FALSE, because ISERR() ignores the #N/A error. +
+
+ + ISERROR function + recognizing;general errors + +mw added "recognizing;" + +

ISERROR

+Tests for error conditions, including the #N/A error value, and returns TRUE or FALSE. + + +ISERROR(Value) +Value is or refers to the value to be tested. ISERROR() returns TRUE if there is an error and FALSE if not. + +=ISERROR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error. +=ISERROR(C9) where cell C9 contains =NA() returns TRUE. +
+
+ + IFERROR function + testing;general errors + + +

IFERROR

+Returns the value if the cell does not contains an error value, or the alternative value if it does. + + +IFERROR(Value; Alternate_value) +Value is the value or expression to be returned if it is not equal or results in an error. +Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an error. + +=IFERROR(C8;C9) where cell C8 contains =1/0 returns the value of C9, because 1/0 is an error. +=IFERROR(C8;C9) where cell C8 contains 13 returns 13, the value of C8, which is not an error. +
+
+ + ISFORMULA function + recognizing formula cells + formula cells;recognizing + +mw inserted "recognizing..." and "formula cells;" + +

ISFORMULA

+Returns TRUE if a cell is a formula cell. + + +ISFORMULA(Reference) +Reference indicates the reference to a cell in which a test will be performed to determine if it contains a formula. + +=ISFORMULA(C4) returns FALSE if the cell C4 contains the number 5. +
+
+ + ISEVEN function + even integers + + +

ISEVEN

+Returns TRUE if the value is an even integer, or FALSE if the value is odd. + +ISEVEN(Value) +Value is the value to be checked. +If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored. + +=ISEVEN(48) returns TRUE +=ISEVEN(33) returns FALSE +=ISEVEN(0) returns TRUE +=ISEVEN(-2.1) returns TRUE +=ISEVEN(3.999) returns FALSEsee also ISODD +
+
+ + ISEVEN_ADD function + + +

ISEVEN_ADD

+Tests for even numbers. Returns 1 if the number divided by 2 returns a whole number. + + +ISEVEN_ADD(Number) +Number is the number to be tested. + +=ISEVEN_ADD(5) returns 0. +=ISEVEN_ADD(A1) returns 1 if cell A1 contains the number 2. +
+
+ + ISNONTEXT function + cell contents;no text + +mw added "cell contents;" + +

ISNONTEXT

+Tests if the cell contents are text or numbers, and returns FALSE if the contents are text. +If an error occurs, the function returns TRUE. + +ISNONTEXT(Value) +Value is any value or expression where a test is performed to determine whether it is a text or numbers or a Boolean value. + +=ISNONTEXT(D2) returns FALSE if cell D2 contains the text abcdef. +=ISNONTEXT(D9) returns TRUE if cell D9 contains the number 8. +
+
+ + ISBLANK function + blank cell contents + empty cells; recognizing + +mw added "blank..." and "empty cells;" + +

ISBLANK

+Returns TRUE if the reference to a cell is blank. This function is used to determine if the content of a cell is empty. A cell with a formula inside is not empty. + + +ISBLANK(Value) +Value is the content to be tested. + +=ISBLANK(D2) returns FALSE as a result. +
+
+ + ISLOGICAL function + number formats;logical + logical number formats + +mw added "number formats;" and "logical..." + +

ISLOGICAL

+Tests for a logical value (TRUE or FALSE). +If an error occurs, the function returns FALSE. + +ISLOGICAL(Value) +Returns TRUE if Value is a logical value (TRUE or FALSE), and returns FALSE otherwise. + +=ISLOGICAL(99) returns FALSE, because 99 is a number, not a logical value. +=ISLOGICAL(ISNA(D4)) returns TRUE whatever the contents of cell D4, because ISNA() returns a logical value. +
+
+ + ISNA function + #N/A error;recognizing + +mw added "#N/A ..." + +

ISNA

+Returns TRUE if a cell contains the #N/A (value not available) error value. +If an error occurs, the function returns FALSE. + +ISNA(Value) +Value is the value or expression to be tested. + +=ISNA(D3) returns FALSE as a result. +
+
+ + IFNA function + #N/A error;testing + + +

IFNA

+Returns the value if the cell does not contains the #N/A (value not available) error value, or the alternative value if it does. + + +IFNA(Value; Alternate_value) +Value is the value or expression to be returned if it is not equal or results in an #N/A error. +Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an #N/A error. + +=IFNA(D3;D4) returns the value of D3 if D3 does not result in an #N/A error, or D4 if it does. +
+
+ + ISTEXT function + cell contents;text + + +

ISTEXT

+Returns TRUE if the cell contents refer to text. +If an error occurs, the function returns FALSE. + +ISTEXT(Value) +Value is a value, number, Boolean value, or an error value to be tested. + +=ISTEXT(D9) returns TRUE if cell D9 contains the text abcdef. +=ISTEXT(C3) returns FALSE if cell C3 contains the number 3. +
+
+ + ISODD function + odd integers + + +

ISODD

+Returns TRUE if the value is odd, or FALSE if the number is even. + +ISODD(value) +Value is the value to be checked. +If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored. + +=ISODD(33) returns TRUE +=ISODD(48) returns FALSE +=ISODD(3.999) returns TRUE +=ISODD(-3.1) returns TRUEsee also ISEVEN +
+
+ + ISODD_ADD function + + +

ISODD_ADD

+Returns TRUE (1) if the number does not return a whole number when divided by 2. + + +ISODD_ADD(Number) +Number is the number to be tested. + +=ISODD_ADD(5) returns 1. +
+
+ + ISNUMBER function + cell contents;numbers + +mw added "cell contents;" + +

ISNUMBER

+Returns TRUE if the value refers to a number. + + +ISNUMBER(Value) +Value is any expression to be tested to determine whether it is a number or text. + +=ISNUMBER(C3) returns TRUE if the cell C3 contains the number 4. +=ISNUMBER(C2) returns FALSE if the cell C2 contains the text abcdef. +
+
+ + N function + + +

N

+Returns the numeric value of the given parameter. Returns 0 if parameter is text or FALSE. +If an error occurs the function returns the error value. + +N(Value) +Value is the parameter to be converted into a number. N() returns the numeric value if it can. It returns the logical values TRUE and FALSE as 1 and 0 respectively. It returns text as 0. + +=N(123) returns 123 +=N(TRUE()) returns 1 +=N(FALSE()) returns 0 +=N("abc") returns 0 +=N(1/0) returns #DIV/0! +
+
+ + NA function + #N/A error;assigning to a cell + +mw added "#N/A error;" + +

NA

+Returns the error value #N/A. + +NA() + +=NA() converts the contents of the cell into #N/A. +
+
+ + TYPE function + + +

TYPE

+Returns the type of value, where 1 = number, 2 = text, 4 = Boolean value, 8 = formula, 16 = error value, 64 = array. + + +TYPE(Value) +Value is a specific value for which the data type is determined. +

Example (see example table above)

+=TYPE(C2) returns 2 as a result. +=TYPE(D9) returns 1 as a result. +
+
+ + CELL function + cell information + information on cells + +mw added two entries + +

CELL

+Returns information on address, formatting or contents of a cell. + +CELL("InfoType" [; Reference]) +InfoType is the character string that specifies the type of information. The character string is always in English. Upper or lower case is optional. + + + + InfoType + + + Meaning + + + + + COL + + + Returns the number of the referenced column. + =CELL("COL";D2) returns 4. + + + + + ROW + + + Returns the number of the referenced row. + =CELL("ROW";D2) returns 2. + + + + + SHEET + + + Returns the number of the referenced sheet. + =CELL("Sheet";Sheet3.D2) returns 3. + + + + + ADDRESS + + + Returns the absolute address of the referenced cell. + =CELL("ADDRESS";D2) returns $D$2. + =CELL("ADDRESS";Sheet3.D2) returns $Sheet3.$D$2. + =CELL("ADDRESS";'X:\dr\test.ods'#$Sheet1.D2) returns 'file:///X:/dr/test.ods'#$Sheet1.$D$2. + + + + + FILENAME + + + Returns the file name and the sheet number of the referenced cell. + =CELL("FILENAME";D2) returns 'file:///X:/dr/own.ods'#$Sheet1, if the formula in the current document X:\dr\own.ods is located in Sheet1. + =CELL("FILENAME";'X:\dr\test.ods'#$Sheet1.D2) returns 'file:///X:/dr/test.ods'#$Sheet1. + + + + + COORD + + + Returns the complete cell address in Lotus™ notation. + =CELL("COORD"; D2) returns $A:$D$2. + =CELL("COORD"; Sheet3.D2) returns $C:$D$2. + + + + + CONTENTS + + + Returns the contents of the referenced cell, without any formatting. + + + + + TYPE + + + Returns the type of cell contents. + b = blank. empty cell + l = label. Text, result of a formula as text + v = value. Value, result of a formula as a number + + + + + WIDTH + + + Returns the width of the referenced column. The unit is the number of zeros (0) that fit into the column in the default text and the default size. + + + + + PREFIX + + + Returns the alignment of the referenced cell. + ' = align left or left-justified + " = align right + ^ = centered + \ = repeating (currently inactive) + + + + + PROTECT + + + Returns the status of the cell protection for the cell. + 1 = cell is protected + 0 = cell is not protected + + + + + FORMAT + + + Returns a character string that indicates the number format. + , = number with thousands separator + F = number without thousands separator + C = currency format + S = exponential representation, for example, 1.234+E56 + P = percentage + In the above formats, the number of decimal places after the decimal separator is given as a number. Example: the number format #,##0.0 returns ,1 and the number format 00.000% returns P3 + D1 = MMM-D-YY, MM-D-YY and similar formats + D2 = DD-MM + D3 = MM-YY + D4 = DD-MM-YYYY HH:MM:SS + D5 = MM-DD + D6 = HH:MM:SS AM/PM + D7 = HH:MM AM/PM + D8 = HH:MM:SS + D9 = HH:MM + G = All other formats + - (Minus) at the end = negative numbers are formatted in color + () (brackets) at the end = there is an opening bracket in the format code + + + + + COLOR + + + Returns 1, if negative values have been formatted in color, otherwise 0. + + + + + PARENTHESES + + + Returns 1 if the format code contains an opening bracket (, otherwise 0. + + +
+Reference (list of options) is the position of the cell to be examined. If Reference is a range, the cell moves to the top left of the range. If Reference is missing, $[officename] Calc uses the position of the cell in which this formula is located. Microsoft Excel uses the reference of the cell in which the cursor is positioned. +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060105.xhp b/helpcontent2/source/text/scalc/01/04060105.xhp new file mode 100644 index 000000000..24f8d9729 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060105.xhp @@ -0,0 +1,202 @@ + + + + + + Logical Functions + /text/scalc/01/04060105.xhp + + + +logical functions + Function Wizard; logical + functions; logical functions + +

Logical Functions

+ This category contains the Logical functions. + +

Handling non-logical arguments in logical functions

+ + + Zero (0) is equivalent to FALSE and all other numbers are equivalent to TRUE. + + + Empty cells and text in cells are ignored. + + + A #VALUE error is raised if all arguments are ignored. + + + A #VALUE error is raised if one argument is direct text (not text in a cell). + + + Errors as argument lead to an error. + + +
+ +
+ + +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+AND function + + +

AND

+ Returns TRUE if all arguments are TRUE. If one of the elements is FALSE, this function returns the FALSE value. + The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values. + + AND() + + + + The logical values of entries 12<13; 14>12, and 7<6 are to be checked: + + =AND(12<13;14>12;7<6) returns FALSE. + + =AND (FALSE;TRUE) returns FALSE. +
+
+FALSE function + + +

FALSE

+ Returns the logical value FALSE. The FALSE() function does not require any arguments, and always returns the logical value FALSE. + + FALSE() + + + =FALSE() returns FALSE + + =NOT(FALSE()) returns TRUE +
+
+IF function + + +

IF

+ Specifies a logical test to be performed. + + IF(Test [; [ThenValue] [; [OtherwiseValue]]]) + + Test is any value or expression that can be TRUE or FALSE. + + ThenValue (optional) is the value that is returned if the logical test is TRUE. + + OtherwiseValue (optional) is the value that is returned if the logical test is FALSE. + + + + + + =IF(A1>5;100;"too small") If the value in A1 is greater than 5, the value 100 is returned; otherwise, the text too small is returned. + + =IF(A1>5;;"too small") If the value in A1 is greater than 5, the value 0 is returned because empty parameters are considered to be 0; otherwise, the text too small is returned. + =IF(A1>5;100;) If the value in A1 is less than 5, the value 0 is returned because the empty OtherwiseValue is interpreted as 0; otherwise 100 is returned. +
+
+NOT function + + +

NOT

+ Complements (inverts) a logical value. + + NOT(LogicalValue) + + LogicalValue is any value to be complemented. + + + =NOT(A). If A=TRUE then NOT(A) will evaluate FALSE. +
+
+OR function + + +

OR

+ Returns TRUE if at least one argument is TRUE. This function returns the value FALSE, if all the arguments have the logical value FALSE. + The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values. + + OR() + + + + The logical values of entries 12<11; 13>22, and 45=45 are to be checked. + + =OR(12<11;13>22;45=45) returns TRUE. + + =OR(FALSE;TRUE) returns TRUE. +
+
+TRUE function + + +

TRUE

+ The logical value is set to TRUE. The TRUE() function does not require any arguments, and always returns the logical value TRUE. + + TRUE() + + If A=TRUE and B=FALSE the following examples appear: + + =AND(A;B) returns FALSE + + =OR(A;B) returns TRUE + + =NOT(AND(A;B)) returns TRUE +
+
+XOR function + + +

XOR

+ Returns true if an odd number of arguments evaluates to TRUE. + The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values. + + + XOR() + + + + =XOR(TRUE;TRUE) returns FALSE + + =XOR(TRUE;TRUE;TRUE) returns TRUE + + =XOR(FALSE;TRUE) returns TRUE +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060106.xhp b/helpcontent2/source/text/scalc/01/04060106.xhp new file mode 100644 index 000000000..753b9f131 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060106.xhp @@ -0,0 +1,1554 @@ + + + + + + + Mathematical Functions + /text/scalc/01/04060106.xhp + + + + + + + mathematical functions + Function Wizard; mathematical + functions; mathematical functions + trigonometric functions + + + +

Mathematical Functions

+This category contains the Mathematical functions for Calc. To open the Function Wizard, choose Insert - Function. + +
+ + ABS function + absolute values + values;absolute + +mw added two entries + + +

ABS

+Returns the absolute value of a number. + + +ABS(Number) +Number is the number whose absolute value is to be calculated. The absolute value of a number is its value without the +/- sign. + + +=ABS(-56) returns 56. +=ABS(12) returns 12. +=ABS(0) returns 0.see also SIGN +
+ +
+ + ACOS function + + + + +

ACOS

+Returns the inverse trigonometric cosine of a number. + + +ACOS(Number) +This function returns the inverse trigonometric cosine of Number, that is the angle (in radians) whose cosine is Number. The angle returned is between 0 and PI. +To return the angle in degrees, use the DEGREES function. + + +=ACOS(-1) returns 3.14159265358979 (PI radians) +=DEGREES(ACOS(0.5)) returns 60. The cosine of 60 degrees is 0.5.see also COS, SIN, TAN, COT, ASIN, ATAN, ATAN2, ACOT + +
+ +
+ + ACOSH function + + + + +

ACOSH

+Returns the inverse hyperbolic cosine of a number. + + +ACOSH(Number) +This function returns the inverse hyperbolic cosine of Number, that is the number whose hyperbolic cosine is Number. +Number must be greater than or equal to 1. + + +=ACOSH(1) returns 0. +=ACOSH(COSH(4)) returns 4.see also ASINH, ATANH, ACOTH, COSH, SINH, TANH, COTH + +
+ +
+ + ACOT function + + + + +

ACOT

+Returns the inverse cotangent (the arccotangent) of the given number. + + +ACOT(Number) +This function returns the inverse trigonometric cotangent of Number, that is the angle (in radians) whose cotangent is Number. The angle returned is between 0 and PI. +To return the angle in degrees, use the DEGREES function. + + +=ACOT(1) returns 0.785398163397448 (PI/4 radians). +=DEGREES(ACOT(1)) returns 45. The tangent of 45 degrees is 1.see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2 + +
+ +
+ + ACOTH function + + + + +

ACOTH

+Returns the inverse hyperbolic cotangent of the given number. + + +ACOTH(Number) +This function returns the inverse hyperbolic cotangent of Number, that is the number whose hyperbolic cotangent is Number. +An error results if Number is between -1 and 1 inclusive. + + +=ACOTH(1.1) returns inverse hyperbolic cotangent of 1.1, approximately 1.52226.see also ACOSH, ASINH, ATANH, COSH, SINH, TANH, COTH + +
+ +
+ +

+ +
+ +
+ + ASIN function + + + + +

ASIN

+Returns the inverse trigonometric sine of a number. + + +ASIN(Number) +This function returns the inverse trigonometric sine of Number, that is the angle (in radians) whose sine is Number. The angle returned is between -PI/2 and +PI/2. +To return the angle in degrees, use the DEGREES function. + + +=ASIN(0) returns 0. +=ASIN(1) returns 1.5707963267949 (PI/2 radians). +=DEGREES(ASIN(0.5)) returns 30. The sine of 30 degrees is 0.5.see also COS, SIN, TAN, COT, ACOS, ATAN, ATAN2, ACOT + +
+ +
+ + ASINH function + + + + +

ASINH

+Returns the inverse hyperbolic sine of a number. + + +ASINH(Number) +This function returns the inverse hyperbolic sine of Number, that is the number whose hyperbolic sine is Number. + + +=ASINH(-90) returns approximately -5.1929877. +=ASINH(SINH(4)) returns 4.see also ACOSH, ATANH, ACOTH, COSH, SINH, TANH, COTH + +
+ +
+ + ATAN function + + + + +

ATAN

+Returns the inverse trigonometric tangent of a number. + + +ATAN(Number) +This function returns the inverse trigonometric tangent of Number, that is the angle (in radians) whose tangent is Number. The angle returned is between -PI/2 and PI/2. +To return the angle in degrees, use the DEGREES function. + + +=ATAN(1) returns 0.785398163397448 (PI/4 radians). +=DEGREES(ATAN(1)) returns 45. The tangent of 45 degrees is 1.see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN2, ACOT + +
+ +
+ + ATAN2 function + + + + +

ATAN2

+Returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY). + + +ATAN2(NumberX; NumberY) +NumberX is the value of the x coordinate. +NumberY is the value of the y coordinate. +Programming languages have usually the opposite order of arguments for their atan2() function. +ATAN2 returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY) + + +=ATAN2(-5;9) returns 2.07789 radians. + +To get the angle in degrees apply the DEGREES function to the result. +=DEGREES(ATAN2(12.3;12.3)) returns 45. The tangent of 45 degrees is 1.see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ACOT +%PRODUCTNAME results 0 for ATAN2(0;0). + +The function can be used in converting cartesian coordinates to polar coordinates. +=DEGREES(ATAN2(-8;5)) returns φ = 147.9 degrees + +Cartesian coordinates to polar coordinates example + + +
+ +
+ + ATANH function + + + + +

ATANH

+Returns the inverse hyperbolic tangent of a number. + + +ATANH(Number) +This function returns the inverse hyperbolic tangent of Number, that is the number whose hyperbolic tangent is Number. +Number must obey the condition -1 < number < 1. + + +=ATANH(0) returns 0.see also ACOSH, ASINH, ACOTH, COSH, SINH, TANH, COTH + +
+ +
+ + COS function + + + + +

COS

+Returns the cosine of the given angle (in radians). + + +COS(Number) +Returns the (trigonometric) cosine of Number, the angle in radians. +To return the cosine of an angle in degrees, use the RADIANS function. + + +=COS(PI()*2) returns 1, the cosine of 2*PI radians. +=COS(RADIANS(60)) returns 0.5, the cosine of 60 degrees.see also SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT + +
+ +
+ + COSH function + + + + +

COSH

+Returns the hyperbolic cosine of a number. + + +COSH(Number) +Returns the hyperbolic cosine of Number. + + +=COSH(0) returns 1, the hyperbolic cosine of 0.see also SINH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH + +
+ +
+ + COT function + + + + +

COT

+Returns the cotangent of the given angle (in radians). + + +COT(Number) +Returns the (trigonometric) cotangent of Number, the angle in radians. +To return the cotangent of an angle in degrees, use the RADIANS function. +The cotangent of an angle is equivalent to 1 divided by the tangent of that angle. + +

Examples:

+=COT(PI()/4) returns 1, the cotangent of PI/4 radians. +=COT(RADIANS(45)) returns 1, the cotangent of 45 degrees.see also COS, SIN, TAN, ACOS, ASIN, ATAN, ATAN2, ACOT + +
+ +
+ + COTH function + + + + +

COTH

+Returns the hyperbolic cotangent of a given number (angle). + + +COTH(Number) +Returns the hyperbolic cotangent of Number. + + +=COTH(1) returns the hyperbolic cotangent of 1, approximately 1.3130.see also COSH, SINH, TANH, ACOSH, ASINH, ATANH, ACOTH + +
+ +
+ + CSC function + + + + +

CSC

+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 + + +CSC(Number) +Returns the (trigonometric) cosecant of Number, the angle in radians. +To return the cosecant of an angle in degrees, use the RADIANS function. + + +=CSC(PI()/4) returns approximately 1.4142135624, the inverse of the sine of PI/4 radians. +=CSC(RADIANS(30)) returns 2, the cosecant of 30 degrees.see also SIN, TAN, COT, SEC, ACOS, ASIN, ATAN, ATAN2, ACOT + +
+ +
+ + CSCH function + + + + +

CSCH

+Returns the hyperbolic cosecant of a number. + + +CSCH(Number) +Returns the hyperbolic cosecant of Number. + + +=CSCH(1) returns approximately 0.8509181282, the hyperbolic cosecant of 1.see also SINH, TANH, COTH, SECH,ACOSH, ASINH, ATANH, ACOTH + +
+ +
+ + DEGREES function + converting;radians, into degrees + +mw added one entry + + +

DEGREES

+Converts radians into degrees. + + +DEGREES(Number) +Number is the angle in radians to be converted to degrees. + + +=DEGREES(PI()) returns 180 degrees.see also RADIANS +
+ +
+ + EXP function + + + + +

EXP

+Returns e raised to the power of a number. The constant e has a value of approximately 2.71828182845904. + + +EXP(Number) +Number is the power to which e is to be raised. + + +=EXP(1) returns 2.71828182845904, the mathematical constant e to Calc's accuracy.see also POWER, LN +
+ +
+ + FACT function + factorials;numbers + +mw added one entry + + +

FACT

+Returns the factorial of a number. + + +FACT(Number) +Returns Number!, the factorial of Number, calculated as 1*2*3*4* ... * Number. +=FACT(0) returns 1 by definition. +The factorial of a negative number returns the "invalid argument" error. + + +=FACT(3) returns 6. +=FACT(0) returns 1.see also FACTDOUBLE, MULTINOMIAL, PRODUCT +
+ +
+ + INT function + numbers;rounding down to next integer + rounding;down to next integer + +mw added two entries + + +

INT

+Rounds a number down to the nearest integer. + + +INT(Number) +Returns Number rounded down to the nearest integer. +Negative numbers round down to the integer below. + + +=INT(5.7) returns 5. +=INT(-1.3) returns -2.see also TRUNC, ROUND, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND +
+ +
+ + EVEN function + numbers;rounding up/down to even integers + rounding;up/down to even integers + +mw added two entries + + +

EVEN

+Rounds a positive number up to the next even integer and a negative number down to the next even integer. + + +EVEN(Number) +Returns Number rounded to the next even integer up, away from zero. + + +=EVEN(2.3) returns 4. +=EVEN(2) returns 2. +=EVEN(0) returns 0. +=EVEN(-0.5) returns -2.see also CEILING, FLOOR, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+ +
+ + GCD function + greatest common divisor + +mw added one entry + + +

GCD

+Returns the greatest common divisor of two or more integers. +The greatest common divisor is the positive largest integer which will divide, without remainder, each of the given integers. + + +GCD() + + + + +=GCD(16;32;24) gives the result 8, because 8 is the largest number that can divide 16, 24 and 32 without a remainder. +=GCD(B1:B3) where cells B1, B2, B3 contain 9, 12, 9 gives 3. +
+ +
+ + GCD_EXCEL2003 function + + +

GCD_EXCEL2003

+The result is the greatest common divisor of a list of numbers. + + +GCD_EXCEL2003() + + +=GCD_EXCEL2003(5;15;25) returns 5. +
+ +
+ + LCM function + least common multiples + lowest common multiples + +mw added two entries + + +

LCM

+Returns the least common multiple of one or more integers. + + +LCM() + + + + +If you enter the numbers 512; 1024 and 2000 as Integer 1;2 and 3, then 128000 will be returned. +
+ +
+ + LCM_EXCEL2003 function + + +

LCM_EXCEL2003

+The result is the lowest common multiple of a list of numbers. + + +LCM_EXCEL2003() + + +=LCM_EXCEL2003(5;15;25) returns 75. +
+ +
+ + COMBIN function + number of combinations + +mw added one entry +should be statistical-->add a link there + +

COMBIN

+Returns the number of combinations for elements without repetition. + + +COMBIN(Count1; Count2) +Count1 is the number of items in the set. +Count2 is the number of items to choose from the set. +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. +COMBIN implements the formula: Count1!/(Count2!*(Count1-Count2)!) + + +=COMBIN(3;2) returns 3.see also COMBINA +
+ +
+ + COMBINA function + number of combinations with repetitions + +mw added one entry +should be statistical-->add a link there + +

COMBINA

+Returns the number of combinations of a subset of items including repetitions. + + +COMBINA(Count1; Count2) +Count1 is the number of items in the set. +Count2 is the number of items to choose from the set. +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. +COMBINA implements the formula: (Count1+Count2-1)! / (Count2!(Count1-1)!)i88052 + + +=COMBINA(3;2) returns 6.see also COMBIN +
+ +
+

TRUNC

+ +
+ +
+ + LN function + natural logarithm + +mw added one entry + + +

LN

+Returns the natural logarithm based on the constant e of a number. The constant e has a value of approximately 2.71828182845904. + + +LN(Number) +Number is the value whose natural logarithm is to be calculated. + + +=LN(3) returns the natural logarithm of 3 (approximately 1.0986). +=LN(EXP(321)) returns 321.see also LOG, LOG10, EXP +
+ +
+ + LOG function + logarithms + +mw added one entry + + +

LOG

+Returns the logarithm of a number to the specified base. + + +LOG(Number [; Base]) +Number is the value whose logarithm is to be calculated. +Base (optional) is the base for the logarithm calculation. If omitted, Base 10 is assumed. + + +=LOG(10;3) returns the logarithm to base 3 of 10 (approximately 2.0959). +=LOG(7^4;7) returns 4.see also LOG10, LN, POWER +
+ +
+ + LOG10 function + base-10 logarithm + +mw added one entry + + +

LOG10

+Returns the base-10 logarithm of a number. + + +LOG10(Number) +Returns the logarithm to base 10 of Number. + + +=LOG10(5) returns the base-10 logarithm of 5 (approximately 0.69897).see also LOG, LN, POWER +
+ + +
+ + PI function + + + + +

PI

+Returns 3.14159265358979, the value of the mathematical constant PI to 14 decimal places. + + +PI() + + +=PI() returns 3.14159265358979. +
+ +
+ + MULTINOMIAL function + + +

MULTINOMIAL

+Returns the factorial of the sum of the arguments divided by the product of the factorials of the arguments. + +MULTINOMIAL() + + + +=MULTINOMIAL(F11:H11) returns 1260, if F11 to H11 contain the values 2, 3 and 4. This corresponds to the formula =(2+3+4)! / (2!*3!*4!) +
+ +
+ + POWER function + + + + +

POWER

+Returns a number raised to another number. + + +POWER(Base; Exponent) +Returns Base raised to the power of Exponent. +The same result may be achieved by using the exponentiation operator ^: +Base^Exponent +=POWER(0,0) returns 1. + +=POWER(4;3) returns 64, which is 4 to the power of 3. +=4^3 also returns 4 to the power of 3.see also EXP, LOG, SQRT +
+ +
+ + SERIESSUM function + + + + +

SERIESSUM

+Sums the first terms of a power series. +SERIESSUM(x;n;m;c) = c1xn + c2xn+m + c3xn+2m + ... + cixn + (i-1)m. + + +SERIESSUM(X; N; M; Coefficients) +X is the input value for the power series. +N is the initial power +M is the increment to increase N +Coefficients is a series of coefficients. For each coefficient the series sum is extended by one section. + +=SERIESSUM(A1; 0; 1; {1; 2; 3}) calculates the value of 1+2x+3x2, where x is the value in cell A1. If A1 contains 1, the formula returns 6; if A1 contains 2, the formula returns 17; if A1 contains 3, the formula returns 34; and so on. +Refer to the SERIESSUM wiki page for more details about this function. +
+ +
+ + PRODUCT function + numbers;multiplying + multiplying;numbers + +mw added two entries + + +

PRODUCT

+Multiplies all the numbers given as arguments and returns the product. + + +PRODUCT() + + + +=PRODUCT(2;3;4) returns 24.see also FACT, SUM +
+ +
+ + SUMSQ function + square number additions + sums;of square numbers + +mw added two entries + + +

SUMSQ

+Calculates the sum of the squares of a set of numbers. + +SUMSQ() + + + +If you enter the numbers 2; 3 and 4 in the Number 1; 2 and 3 arguments, 29 is returned as the result. +
+ +
+ + MOD function + remainders of divisions + + + +

MOD

+Returns the remainder when one integer is divided by another. + + +MOD(Dividend; Divisor) +For integer arguments this function returns Dividend modulo Divisor, that is the remainder when Dividend is divided by Divisor. +This function is implemented as Dividend - Divisor * INT(Dividend/Divisor) , and this formula gives the result if the arguments are not integer. + + +=MOD(22;3) returns 1, the remainder when 22 is divided by 3. +=MOD(11.25;2.5) returns 1.25.see also QUOTIENT, INT +
+ +
+ + QUOTIENT function + divisions + +mw added one entry + + +

QUOTIENT

+Returns the integer part of a division operation. + + +QUOTIENT(Numerator; Denominator) +Returns the integer part of Numerator divided by Denominator. +QUOTIENT is equivalent to INT(numerator/denominator) for same-sign numerator and denominator, except that it may report errors with different error codes. More generally, it is equivalent to INT(numerator/denominator/SIGN(numerator/denominator))*SIGN(numerator/denominator). + + +=QUOTIENT(11;3) returns 3. The remainder of 2 is lost.see also MOD, INT +
+ +
+ + RADIANS function + converting;degrees, into radians + +mw added one entry + + +

RADIANS

+Converts degrees to radians. + + +RADIANS(Number) +Number is the angle in degrees to be converted to radians. + + +=RADIANS(90) returns 1.5707963267949, which is PI/2 to Calc's accuracy.see also DEGREES +
+ +
+ +
+ +
+ + ROUND function + + + + +

ROUND

+Rounds a number to a certain number of decimal places. + + +ROUND(Number [; Count]) +Returns Number rounded to Count 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. +This function rounds to the nearest number. See ROUNDDOWN and ROUNDUP for alternatives. + + +=ROUND(2.348;2) returns 2.35 +=ROUND(-32.4834;3) returns -32.483. Change the cell format to see all decimals. +=ROUND(2.348;0) returns 2. +=ROUND(2.5) returns 3. +=ROUND(987.65;-2) returns 1000.see also INT, TRUNC, ROUNDDOWN, ROUNDUP, CEILING, FLOOR, EVEN, ODD, MROUND +
+ +
+

ROUNDDOWN

+ +
+ +
+ + ROUNDUP function + + + + +

ROUNDUP

+Rounds a number up, away from zero, to a certain precision. + + +ROUNDUP(Number [; Count]) +Returns Number rounded up (away from zero) to Count 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. +This function rounds away from zero. See ROUNDDOWN and ROUND for alternatives. + + +=ROUNDUP(1.1111;2) returns 1.12. +=ROUNDUP(1.2345;1) returns 1.3. +=ROUNDUP(45.67;0) returns 46. +=ROUNDUP(-45.67) returns -46. +=ROUNDUP(987.65;-2) returns 1000.see also INT, TRUNC, ROUND, ROUNDDOWN, CEILING, FLOOR, EVEN, ODD, MROUND +
+ +
+ + SEC function + + + + +

SEC

+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 + + +SEC(Number) +Returns the (trigonometric) secant of Number, the angle in radians. +To return the secant of an angle in degrees, use the RADIANS function. + + +=SEC(PI()/4) returns approximately 1.4142135624, the inverse of the cosine of PI/4 radians. +=SEC(RADIANS(60)) returns 2, the secant of 60 degrees.see also SIN, TAN, COT, CSC, ACOS, ASIN, ATAN, ATAN2, ACOT + +
+ +
+ + SECH function + + + + +

SECH

+Returns the hyperbolic secant of a number. + + +SECH(Number) +Returns the hyperbolic secant of Number. + + +=SECH(0) returns 1, the hyperbolic secant of 0.see also SINH, TANH, COTH, CSCH, ACOSH, ASINH, ATANH, ACOTH + +
+ +
+ + SIN function + + + + +

SIN

+Returns the sine of the given angle (in radians). + + +SIN(Number) +Returns the (trigonometric) sine of Number, the angle in radians. +To return the sine of an angle in degrees, use the RADIANS function. + + +=SIN(PI()/2) returns 1, the sine of PI/2 radians. +=SIN(RADIANS(30)) returns 0.5, the sine of 30 degrees.see also COS, TAN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT + +
+ +
+ + SINH function + + + + +

SINH

+Returns the hyperbolic sine of a number. + + +SINH(Number) +Returns the hyperbolic sine of Number. + + +=SINH(0) returns 0, the hyperbolic sine of 0.see also COSH, TANH, COTH, ACOSH, ASINH, ATANH, ACOTH + +
+ +
+

+ +
+ +
+ + SUMIF function + adding;specified numbers + +mw added one entry + + +

SUMIF

+Adds the cells specified by a given criterion. This function is used to sum a range when you search for a certain value. + + +SUMIF(Range; Criterion [; SumRange]) +Range is the range to which the criterion is to be applied. + +SumRange is the range from which values are summed. If this parameter has not been indicated, the values found in the Range are summed. +SUMIF supports the reference concatenation operator (~) only in the Criterion parameter, and only if the optional SumRange parameter is not given. + + +To sum up only negative numbers: =SUMIF(A1:A10;"<0") +=SUMIF(A1:A10;">0";B1:B10) - sums values from the range B1:B10 only if the corresponding values in the range A1:A10 are >0. +See COUNTIF() for some more syntax examples that can be used with SUMIF(). +
+ +
+ +
+ +
+ +

+ +
+ +
+ + TAN function + + + + +

TAN

+Returns the tangent of the given angle (in radians). + + +TAN(Number) +Returns the (trigonometric) tangent of Number, the angle in radians. +To return the tangent of an angle in degrees, use the RADIANS function. + + +=TAN(PI()/4) returns 1, the tangent of PI/4 radians. +=TAN(RADIANS(45)) returns 1, the tangent of 45 degrees.see also COS, SIN, COT, ACOS, ASIN, ATAN, ATAN2, ACOT + +
+ +
+ + TANH function + + + + +

TANH

+Returns the hyperbolic tangent of a number. + + +TANH(Number) +Returns the hyperbolic tangent of Number. + + +=TANH(0) returns 0, the hyperbolic tangent of 0.see also COSH, SINH, COTH, ACOSH, ASINH, ATANH, ACOTH + +
+ +
+ + AutoFilter function; subtotals + sums;of filtered data + filtered data; sums + SUBTOTAL function + + + +

SUBTOTAL

+Calculates subtotals. 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. + + +SUBTOTAL(Function; Range) +Function is a number that stands for one of the following functions: + + + + + Function index + (includes hidden values) + + + Function index + (ignores hidden values) + + + Function + + + + + 1 + + + 101 + + + AVERAGE + + + + + 2 + + + 102 + + + COUNT + + + + + 3 + + + 103 + + + COUNTA + + + + + 4 + + + 104 + + + MAX + + + + + 5 + + + 105 + + + MIN + + + + + 6 + + + 106 + + + PRODUCT + + + + + 7 + + + 107 + + + STDEV + + + + + 8 + + + 108 + + + STDEVP + + + + + 9 + + + 109 + + + SUM + + + + + 10 + + + 110 + + + VAR + + + + + 11 + + + 111 + + + VARP + + +
+ +Use numbers 1-11 to include manually hidden rows or 101-111 to exclude them; filtered-out cells are always excluded. +Range is the range whose cells are included. + + + +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: + + + + + + + + A + + + B + + + + + 1 + + + ITEM + + + QUANTITY + + + + + 2 + + + Pen + + + 10 + + + + + 3 + + + Pencil + + + 10 + + + + + 4 + + + Notebook + + + 10 + + + + + 5 + + + Rubber + + + 10 + + + + + 6 + + + Sharpener + + + 10 + + +
+ +=SUBTOTAL(9;B2:B6) returns 50. +=SUBTOTAL(109;B2:B6) returns 40. +
+ +
+ + Euro; converting + EUROCONVERT function + + + + + +

EUROCONVERTinsert link in financial

+Converts between old European national currency and to and from Euros. + + +EUROCONVERT(Value; "From_currency"; "To_currency" [; full_precision [; triangulation_precision]]) +Value is the amount of the currency to be converted. +From_currency and To_currency 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. +Full_precision 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. +Triangulation_precision is optional. If Triangulation_precision is given and >=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. + +

Examples

+=EUROCONVERT(100;"ATS";"EUR") converts 100 Austrian Schillings into Euros. +=EUROCONVERT(100;"EUR";"DEM") converts 100 Euros into German Marks. +
+ +
+ + CONVERT_OOO function + + + + +

CONVERT_OOO

+Converts to euros a currency value expressed in one of the legacy currencies of 19 member states of the Eurozone, and vice versa. The conversion uses the fixed exchange rates at which the legacy currencies entered the euro. + +We recommend using the more flexible EUROCONVERT function for converting between these currencies. CONVERT_OOO is not a standardized function and is not portable. + + +CONVERT_OOO(Value; "Text1"; "Text2") +Value is the amount of the currency to be converted. +Text1 is a three-character string that specifies the currency to be converted from. +Text2 is a three-character string that specifies the currency to be converted to. +Text1 and Text2 must each take one of the following values: "ATS", "BEF", "CYP", "DEM", "EEK", "ESP", "EUR", "FIM", "FRF", "GRD", "IEP", "ITL", "LTL", "LUF", "LVL", "MTL", "NLG", "PTE", "SIT", and "SKK". +One, and only one, of Text1 or Text2 must be equal to "EUR". + + +=CONVERT_OOO(100;"ATS";"EUR") returns the euro value of 100 Austrian schillings. +=CONVERT_OOO(100;"EUR";"DEM") converts 100 euros into German marks. +Refer to the CONVERT_OOO wiki page for more details about this function. +
+ +
+ + ODD function + rounding;up/down to nearest odd integer + +mw added one entry + + +

ODD

+Rounds a positive number up to the nearest odd integer and a negative number down to the nearest odd integer. + + +ODD(Number) +Returns Number rounded to the next odd integer up, away from zero. + + +=ODD(1.2) returns 3. +=ODD(1) returns 1. +=ODD(0) returns 1. +=ODD(-3.1) returns -5.see also CEILING, FLOOR, EVEN, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+ +
+ + SIGN function + algebraic signs + +mw added one entry + + +

SIGN

+Returns the sign of a number. Returns 1 if the number is positive, -1 if negative and 0 if zero. + + +SIGN(Number) +Number is the number whose sign is to be determined. + + +=SIGN(3.4) returns 1. +=SIGN(-4.5) returns -1.see also ABS +
+ +
+ + MROUND function + nearest multiple + +mw added one entry + + +

MROUND

+Returns a number rounded to the nearest multiple of another number. + + +MROUND(Number; Multiple) +Returns Number rounded to the nearest multiple of Multiple. +An alternative implementation would be Multiple * ROUND(Number/Multiple). + + +=MROUND(15.5;3) returns 15, as 15.5 is closer to 15 (= 3*5) than to 18 (= 3*6). +=MROUND(1.4;0.5) returns 1.5 (= 0.5*3).see also CEILING, FLOOR, EVEN, ODD, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+ +
+ + SQRT function + square roots;positive numbers + +mw added one entry + + +

SQRT

+Returns the positive square root of a number. + + +SQRT(Number) +Returns the positive square root of Number. +Number must be positive. + + +=SQRT(16) returns 4. +=SQRT(-16) returns an invalid argument error.see also SQRTPI, POWER +
+ +
+ + SQRTPI function + square roots;products of Pi + +mw added one entry + + +

SQRTPI

+Returns the square root of (PI times a number). + + +SQRTPI(Number) +Returns the positive square root of (PI multiplied by Number). +This is equivalent to SQRT(PI()*Number). + + +=SQRTPI(2) returns the squareroot of (2PI), approximately 2.506628.see also SQRT +
+ +
+ +random numbers; between limits +RANDBETWEEN function + +mw changed "random numbers;" + + +

RANDBETWEEN

+Returns an integer random number in a specified range. + + +RANDBETWEEN(Bottom; Top) +Returns an integer random number between integers Bottom and Top (both inclusive). +This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9. +To generate random numbers which never recalculate, copy cells containing this function, and use Edit - Paste Special (with Paste All and Formulas not marked and Numbers marked). + + +=RANDBETWEEN(20;30) returns an integer of between 20 and 30.see also RAND +
+
+ +random numbers non-volatile; between limits +RANDBETWEEN.NV function + + +

RANDBETWEEN.NV

+Returns an non-volatile integer random number in a specified range. + +RANDBETWEEN.NV(Bottom; Top) +Returns an non-volatile integer random number between integers Bottom and Top (both inclusive). A non-volatile function is not recalculated at new input events or pressing F9. However, the function is recalculated when pressing F9 with the cursor on the cell containing the function, when opening the file, when using the Recalculate Hard command (Shift+CommandCtrl+F9) and when Top or Bottom are recalculated. + +=RANDBETWEEN.NV(20;30) returns a non-volatile integer between 20 and 30. +=RANDBETWEEN.NV(A1;30) returns a non-volatile integer between the value of cell A1 and 30. The function is recalculated when the contents of cell A1 change. + + + +ORG.LIBREOFFICE.RANDBETWEEN.NV +
+ +
+ +RAND function +random numbers;between 0 and 1 + +mw added one entry + + +

RAND

+Returns a random number between 0 and 1.The value of 0 can be returned, the value of 1 not.this is really true after issue 53642 will be fixed + + +RAND() +This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9. +To generate random numbers which never recalculate, either: + + + Copy cells each containing =RAND(), and use Edit - Paste Special (with Paste All and Formulas not marked and Numbers marked). + + + Use the Fill Cell command with random numbers (Sheet - Fill Cells - Fill Random Numbers). + + + Use the RAND.NV() function for non-volatile random numbers. + + + +=RAND() returns a random number between 0 and 1.see also RANDBETWEEN +
+
+ +random numbers non-volatile;between 0 and 1 +RAND.NV function + + +

RAND.NV

+Returns a non-volatile random number between 0 and 1. + +RAND.NV() +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 F9, except when the cursor is on the cell containing the function or using the Recalculate Hard command (Shift+CommandCtrl+F9). The function is recalculated when opening the file. + +=RAND.NV() returns a non-volatile random number between 0 and 1. + + + +ORG.LIBREOFFICE.RAND.NV +
+ + +
+ +
+ + + diff --git a/helpcontent2/source/text/scalc/01/04060107.xhp b/helpcontent2/source/text/scalc/01/04060107.xhp new file mode 100644 index 000000000..86514c411 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060107.xhp @@ -0,0 +1,1162 @@ + + + + + + + Array Functions + /text/scalc/01/04060107.xhp + + + + +matrices; functions +Function Wizard; arrays +array formulas +inline array constants +formulas; arrays +functions; array functions +editing; array formulas +copying; array formulas +deleting; array formulas +adjusting array ranges +calculating; conditional calculations +matrices; calculations +conditional calculations with arrays +implicit array handling +forced array handling + +mw deleted "creating;" +

Array Functions

+ This category contains the array functions. +

What is an Array?

+ An array is a linked range of cells on a spreadsheet containing values. A square range of 3 rows and 3 columns is a 3 x 3 array: + + + + + + A + + + B + + + C + + + + + 1 + + + 7 + + + 31 + + + 33 + + + + + 2 + + + 95 + + + 17 + + + 2 + + + + + 3 + + + 5 + + + 10 + + + 50 + + +
+ The smallest possible array is a 1 x 2 or 2 x 1 array with two adjacent cells. +

What is an array formula?

+ A formula in which the individual values in a cell range are evaluated is referred to as an array formula. The difference between an array formula and other formulas is that the array formula deals with several values simultaneously instead of just one. + Not only can an array formula process several values, but it can also return several values. The results of an array formula is also an array. + To multiply the values in the individual cells by 10 in the above array, you do not need to apply a formula to each individual cell or value. Instead you just need to use a single array formula. Select a range of 3 x 3 cells on another part of the spreadsheet, enter the formula =10*A1:C3 and confirm this entry using the key combination CommandCtrl + Shift + Enter. The result is a 3 x 3 array in which the individual values in the cell range (A1:C3) are multiplied by a factor of 10. + In addition to multiplication, you can also use other operators on the reference range (an array). With $[officename] Calc, you can add (+), subtract (-), multiply (*), divide (/), use exponents (^), concatenation (&) and comparisons (=, <>, <, >, <=, >=). The operators can be used on each individual value in the cell range and return the result as an array if the array formula was entered. + Comparison operators in an array formula treat empty cells in the same way as in a normal formula, that is, either as zero or as an empty string. For example, if cells A1 and A2 are empty the array formulas {=A1:A2=""} and {=A1:A2=0} will both return a 1 column 2 row array of cells containing TRUE. +

When do you use array formulas?

+ Use array formulas if you have to repeat calculations using different values. If you decide to change the calculation method later, you only have to update the array formula. To add an array formula, select the entire array range and then make the required change to the array formula. + Array formulas are also a space saving option when several values must be calculated, since they are not very memory-intensive. In addition, arrays are an essential tool for carrying out complex calculations, because you can have several cell ranges included in your calculations. $[officename] has different math functions for arrays, such as the MMULT function for multiplying two arrays or the SUMPRODUCT function for calculating the scalar products of two arrays. +

Using Array Formulas in $[officename] Calc

+ You can also create a "normal" formula in which the reference range, such as parameters, indicate an array formula. The result is obtained from the intersection of the reference range and the rows or columns in which the formula is found. If there is no intersection or if the range at the intersection covers several rows or columns, a #VALUE! error message appears. The following example illustrates this concept: +

Creating Array Formulas

+
+ If you create an array formula using the Function Wizard, you must mark the Array check box each time so that the results are returned in an array. Otherwise, only the value in the upper-left cell of the array being calculated is returned. + If you enter the array formula directly into the cell, you must use the key combination Shift + CommandCtrl + Enter instead of the Enter key. Only then does the formula become an array formula. + Array formulas appear in braces in $[officename] Calc. You cannot create array formulas by manually entering the braces. +
+ The cells in a results array are automatically protected against changes. However, you can edit, delete or copy the array formula by selecting the entire array cell range. +

Using Inline Array Constants in Formulas

+ Calc supports inline matrix/array constants in formulas. An inline array is surrounded by curly braces '{' and '}'. Elements can be each a number (including negatives), a logical constant (TRUE, FALSE), or a literal string. Non-constant expressions are not allowed. Arrays can be entered with one or more rows, and one or more columns. All rows must consist of the same number of elements, all columns must consist of the same number of elements. + The column separator (separating elements in one row) and the row separator are language and locale dependent. But in this help content, the ';' semicolon and '|' pipe symbol are used to indicate the column and row separators, respectively. For example, in the English locale, the ',' comma is used as the column separator, while the ';' semicolon is used as the row separator. + You can view and change the row and column separator in %PRODUCTNAME - PreferencesTools - Options - Calc - Formula - Separators. + Arrays can not be nested. + Examples: + ={1;2;3} + An array with one row consisting of the three numbers 1, 2, and 3. + To enter this array constant, you select three cells in a row, then you type the formula ={1;2;3} using the curly braces and the semicolons, then press CommandCtrl + Shift + Enter. + ={1;2;3|4;5;6} + An array with two rows and three values in each row. + ={0;1;2|FALSE;TRUE;"two"} + A mixed data array. + =SIN({1;2;3}) + Entered as a matrix formula, delivers the result of three SIN calculations with the arguments 1, 2, and 3. +

Editing Array Formulas

+ + + Select the cell range or array containing the array formula. To select the whole array, position the cell cursor inside the array range, then press CommandCtrl + /, where / is the division key on the numeric keypad. + + + Either press F2 or position the cursor in the input line. Both of these actions let you edit the formula. + + + After you have made changes, press CommandCtrl + Shift + Enter. + + + You can format the separate parts of an array. For example, you can change the font color. Select a cell range and then change the attribute you want. + +

Deleting Array Formulae

+ + + Select the cell range or array containing the array formula. To select the whole array, position the cell cursor inside the array range, then press CommandCtrl + /, where / is the division key on the numeric keypad. + + + Press Delete to delete the array contents, including the array formula, or press Backspace and this brings up the Delete Contents dialog box. Select Formula or Delete All and click OK. + + + +

Copying Array Formulas

+ + + Select the cell range or array containing the array formula. + + + Either press F2 or position the cursor in the input line. + + + Copy the formula into the input line by pressing CommandCtrl + C. + + + Select a range of cells where you want to insert the array formula and either press F2 or position the cursor in the input line. + + + Paste the formula by pressing CommandCtrl + V in the selected space and confirm it by pressing CommandCtrl + Shift + Enter. The selected range now contains the array formula. + + +

Adjusting an Array Range

+ If you want to edit the output array, do the following: + + + Select the cell range or array containing the array formula. + + + Below the selection, to the right, you will see a small icon with which you can zoom in or out on the range using your mouse. + + + When you adjust the array range, the array formula will not automatically be adjusted. You are only changing the range in which the result will appear. + By holding down the CommandCtrl key, you can create a copy of the array formula in the given range. +

Conditional Array Calculations

+ A conditional array calculation is an array or matrix formula that includes an IF() or CHOOSE() function. The condition argument in the formula is an area reference or a matrix result. + In the following example, the >0 test of the {=IF(A1:A3>0;"yes";"no")} formula is applied to each cell in the range A1:A3 and the result is copied to the corresponding cell. + + + + + + A + + + B (formula) + + + B (result) + + + + + 1 + + + 1 + + + {=IF(A1:A3>0;"yes";"no")} + + + yes + + + + + 2 + + + 0 + + + {=IF(A1:A3>0;"yes";"no")} + + + no + + + + + 3 + + + 1 + + + {=IF(A1:A3>0;"yes";"no")} + + + yes + + +
+ The following functions provide forced array handling: CORREL, COVAR, FORECAST, FTEST, INTERCEPT, MDETERM, MINVERSE, MMULT, MODE, PEARSON, PROB, RSQ, SLOPE, STEYX, SUMPRODUCT, SUMX2MY2, SUMX2PY2, SUMXMY2, TTEST. If you use area references as arguments when you call one of these functions, the functions behave as array functions. The following table provides an example of forced array handling: + + + + + + A + + + B (formula) + + + B (result) + + + C (forced array formula) + + + C (result) + + + + + 1 + + + 1 + + + =A1:A2+1 + + + 2 + + + =SUMPRODUCT(A1:A2+1) + + + 5 + + + + + 2 + + + 2 + + + =A1:A2+1 + + + 3 + + + =SUMPRODUCT(A1:A2+1) + + + 5 + + + + + 3 + + + + + =A1:A2+1 + + + #VALUE! + + + =SUMPRODUCT(A1:A2+1) + + + 5 + + +
+ +
+ +MUNIT function + + +

MUNIT

+ Returns the unitary square array of a certain size. The unitary array is a square array where the main diagonal elements equal 1 and all other array elements are equal to 0. + + MUNIT(Dimensions) + Dimensions refers to the size of the array unit. + You can find a general introduction to Array functions at the top of this page. + + Select a square range within the spreadsheet, for example, from A1 to E5. + Without deselecting the range, select the MUNIT function. Mark the Array check box. Enter the desired dimensions for the array unit, in this case 5, and click OK. + You can also enter the =MUNIT(5) formula in the last cell of the selected range (E5), and press Shift + Command + EnterShift + Ctrl + Enter. + You now see a unit array with a range of A1:E5. + +
+
+ +FREQUENCY function + + +

FREQUENCY

+ Indicates the frequency distribution in a one-column-array. The function counts the number of values in the Data array that are within the values given by the Classes array. + + FREQUENCY(Data; Classes) + Data represents the reference to the values to be counted. + Classes represents the array of the limit values. + + You can find a general introduction to Array functions at the top of this page. + + In the following table, column A lists unsorted measurement values. Column B contains the upper limit you entered for the classes into which you want to divide the data in column A. According to the limit entered in B1, the FREQUENCY function returns the number of measured values less than or equal to 5. As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 and less than or equal to 10. The text you entered in B6, ">25", is only for reference purposes.i77461: replace old text: As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 or greater than or equal to 10.UFI: replace table by picture + + + + + + A + + + B + + + C + + + + + 1 + + + 12 + + + 5 + + + 1 + + + + + 2 + + + 8 + + + 10 + + + 3 + + + + + 3 + + + 24 + + + 15 + + + 2 + + + + + 4 + + + 11 + + + 20 + + + 3 + + + + + 5 + + + 5 + + + 25 + + + 1 + + + + + 6 + + + 20 + + + >25 + + + 1 + + + + + 7 + + + 16 + + + + + + + + + 8 + + + 9 + + + + + + + + + 9 + + + 7 + + + + + + + + + 10 + + + 16 + + + + + + + + + 11 + + + 33 + + + + + + +
+ Select a single column range in which to enter the frequency according to the class limits. You must select one field more than the class ceiling. In this example, select the range C1:C6. Call up the FREQUENCY function in the Function Wizard. Select the Data range in (A1:A11), and then the Classes range in which you entered the class limits (B1:B6). Select the Array check box and click OK. You will see the frequency count in the range C1:C6. + +
+
+ +MDETERM function +determinants + + +

MDETERM

+ Returns the array determinant of an array. This function returns a value in the current cell; it is not necessary to define a range for the results. + + MDETERM(Array) + Array represents a square array in which the determinants are defined. + You can find a general introduction to using Array functions on top of this page. + +
+
+ +MINVERSE function +inverse arrays + + +

MINVERSE

+ Returns the inverse array. + + MINVERSE(Array) + Array represents a square array that is to be inverted. + + + Select a square range and select MINVERSE. Select the output array, select the Array field and click OK. +
+
+ +MMULT function + + +

MMULT

+ Calculates the array product of two arrays. The number of columns for array 1 must match the number of rows for array 2. The square array has an equal number of rows and columns. + + MMULT(Array 1; Array 2) + Array 1 represents the first array used in the array product. + Array 2 represents the second array with the same number of rows. + + + Select a square range. Choose the MMULT function. Select Array 1, then select Array 2. Using the Function Wizard, mark the Array check box. Click OK. The output array will appear in the first selected range. +
+
+ +TRANSPOSE function + + +

TRANSPOSE

+ Transposes the rows and columns of an array. + + TRANSPOSE(Array) + Array represents the array in the spreadsheet that is to be transposed. + You can find a general introduction to using Array functions on top of this page. + + In the spreadsheet, select the range in which the transposed array can appear. If the original array has n rows and m columns, your selected range must have at least m rows and n columns. Then enter the formula directly, select the original array and press Shift + Command + EnterShift + Ctrl + Enter. Or, if you are using the Function Wizard, mark the Array check box. The transposed array appears in the selected target range and is protected automatically against changes. + + + + + + A + + + B + + + C + + + D + + + + + 1 + + + 2 + + + 3 + + + 4 + + + 5 + + + + + 2 + + + 6 + + + 7 + + + 8 + + + 9 + + +
+ The above table is 2 rows, 4 columns. In order to transpose it, you must select 4 rows, 2 columns. Assuming you want to transpose the above table to the range A7:B10 (4 rows, 2 columns) you must select the entire range and then enter the following: + TRANSPOSE(A1:D2) + Then make sure to enter it as matrix formula with Shift + Command + EnterShift + Ctrl + Enter. The result will be as follows: + + + + + + A + + + B + + + + + 7 + + + 2 + + + 6 + + + + + 8 + + + 3 + + + 7 + + + + + 9 + + + 4 + + + 8 + + + + + 10 + + + 5 + + + 9 + + +
+
+
+ +LINEST function + + +

LINEST

+ Returns a table of statistics for a straight line that best fits a data set.changed based on https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_LINEST_function (issue 76142) + + LINEST(data_Y [; data_X [; linearType [; stats]]]) + data_Y is a single row or column range specifying the y coordinates in a set of data points. + data_X is a corresponding single row or column range specifying the x coordinates. If data_X is omitted it defaults to 1, 2, 3, ..., n. If there is more than one set of variables data_X may be a range with corresponding multiple rows or columns. + LINEST finds a straight line y = a + bx that best fits the data, using linear regression (the "least squares" method). With more than one set of variables the straight line is of the form y = a + b1x1 + b2x2 ... + bnxn. + If linearType is FALSE the straight line found is forced to pass through the origin (the constant a is zero; y = bx). If omitted, linearType defaults to TRUE (the line is not forced through the origin). + If stats is omitted or FALSE only the top line of the statistics table is returned. If TRUE the entire table is returned. + LINEST returns a table (array) of statistics as below and must be entered as an array formula (for example by using CommandCtrl + Shift + Return rather than just Return). + + + + This function returns an array and is handled in the same way as the other array functions. Select a range for the answers and then the function. Select data_Y. If you want, you can enter other parameters. Select Array and click OK. + The results returned by the system (if stats = 0), will at least show the slope of the regression line and its intersection with the Y axis. If stats does not equal 0, other results are to be displayed. +

Other LINEST Results:

+ Examine the following examples: + + + + + + A + + + B + + + C + + + D + + + E + + + F + + + G + + + + + 1 + + + x1 + + + x2 + + + y + + + + + LINEST value + + + + + + + + + 2 + + + 4 + + + 7 + + + 100 + + + + + 4,17 + + + -3,48 + + + 82,33 + + + + + 3 + + + 5 + + + 9 + + + 105 + + + + + 5,46 + + + 10,96 + + + 9,35 + + + + + 4 + + + 6 + + + 11 + + + 104 + + + + + 0,87 + + + 5,06 + + + #NA + + + + + 5 + + + 7 + + + 12 + + + 108 + + + + + 13,21 + + + 4 + + + #NA + + + + + 6 + + + 8 + + + 15 + + + 111 + + + + + 675,45 + + + 102,26 + + + #NA + + + + + 7 + + + 9 + + + 17 + + + 120 + + + + + + + + + + + + + 8 + + + 10 + + + 19 + + + 133 + + + + + + + + + + +
+ Column A contains several X1 values, column B several X2 values and column C the Y values. You have already entered these values in your spreadsheet. You have now set up E2:G6 in the spreadsheet and activated the Function Wizard. For the LINEST function to work, you must have marked the Array check box in the Function Wizard. Next, select the following values in the spreadsheet (or enter them using the keyboard): + data_Y is C2:C8 + data_X is A2:B8 + linearType and stats are both set to 1. + As soon as you click OK, $[officename] Calc will fill the above example with the LINEST values as shown in the example. + The formula in the Formula bar corresponds to each cell of the LINEST array {=LINEST(C2:C8;A2:B8;1;1)}. + This represents the calculated LINEST values: + +slopes, see also regression lines +regression lines; LINEST function + +mw made "regression lines" a two level entry + E2 and F2: Slope m of the regression line y=b+m*x for the x1 and x2 values. The values are given in reverse order; that is, the slope for x2 in E2 and the slope for x1 in F2. + G2: Intersection b with the y axis. + +standard errors; array functions + +MW changed "standard errors" + E3 and F3: The standard error of the slope value. + G3: The standard error of the intercept + +RSQ calculations + + E4: RSQ + F4: The standard error of the regression calculated for the Y value. + E5: The F value from the variance analysis. + F5: The degrees of freedom from the variance analysis. + E6: The sum of the squared deviation of the estimated Y values from their linear mean. + F6: The sum of the squared deviation of the estimated Y value from the given Y values. + +
+
+ +LOGEST function + + +

LOGEST

+ This function calculates the adjustment of the entered data as an exponential regression curve (y=b*m^x).UFI: see http://support.microsoft.com/default.aspx?kbid=828528&product=xl2003 for bug #i31051# + + LOGEST(DataY [; DataX [; FunctionType [; Stats]]]) + DataY represents the Y Data array. + DataX (optional) represents the X Data array. + FunctionType (optional). If Function_Type = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated. + Stats (optional). If Stats=0, only the regression coefficient is calculated. + + + + See LINEST. However, no square sum will be returned. +
+
+ +SUMPRODUCT function +scalar products +dot products +inner products + + +

SUMPRODUCT

+ Multiplies corresponding elements in the given arrays, and returns the sum of those products. + + SUMPRODUCT(Array 1[; Array 2;][...;[Array 255]]) + Array 1[; Array 2;][...;[Array 255]] represent arrays whose corresponding elements are to be multiplied. + At least one array must be part of the argument list. If only one array is given, all array elements are summed. If more than one array is given, they must all be the same size. + + + + + + + A + + + B + + + C + + + D + + + + + 1 + + + 2 + + + 3 + + + 4 + + + 5 + + + + + 2 + + + 6 + + + 7 + + + 8 + + + 9 + + + + + 3 + + + 10 + + + 11 + + + 12 + + + 13 + + +
+ =SUMPRODUCT(A1:B3;C1:D3) returns 397. + Calculation: A1*C1 + B1*D1 + A2*C2 + B2*D2 + A3*C3 + B3*D3 + You can use SUMPRODUCT to calculate the scalar product of two vectors. + SUMPRODUCT returns a single number, it is not necessary to enter the function as an array function. + +
+
+ +SUMX2MY2 function + + +

SUMX2MY2

+ Returns the sum of the difference of squares of corresponding values in two arrays. + + SUMX2MY2(ArrayX; ArrayY) + ArrayX represents the first array whose elements are to be squared and added. + ArrayY represents the second array whose elements are to be squared and subtracted. + +
+
+ +SUMX2PY2 function + + +

SUMX2PY2

+ Returns the sum of the sum of squares of corresponding values in two arrays. + + SUMX2PY2(ArrayX; ArrayY) + ArrayX represents the first array whose elements are to be squared and added. + ArrayY represents the second array, whose elements are to be squared and added. + +
+
+ +SUMXMY2 function + + +

SUMXMY2

+ Adds the squares of the variance between corresponding values in two arrays. + + SUMXMY2(ArrayX; ArrayY) + ArrayX represents the first array whose elements are to be subtracted and squared. + ArrayY represents the second array, whose elements are to be subtracted and squared. + +
+
+ +TREND function + + +

TREND

+ Returns values along a linear trend. + + TREND(DataY [; DataX [; NewDataX [; LinearType]]]) + DataY represents the Y Data array. + DataX (optional) represents the X Data array. + NewDataX (optional) represents the array of the X data, which are used for recalculating values. + LinearType (optional). If LinearType = 0, then lines will be calculated through the zero point. Otherwise, offset lines will also be calculated. The default is LinearType <> 0. + + + + Select a spreadsheet range in which the trend data will appear. Select the function. Enter the output data or select it with the mouse. Mark the Array field, click OK. The trend data calculated from the output data is displayed. +
+
+ +GROWTH function +exponential trends in arrays + + +

GROWTH

+ Calculates the points of an exponential trend in an array. + + GROWTH(DataY [; [ DataX ] [; [ NewDataX ] [; FunctionType ] ] ]) + DataY represents the Y Data array. + DataX (optional) represents the X Data array. + NewDataX (optional) represents the X data array, in which the values are recalculated. + FunctionType (optional). If FunctionType = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated. + + + + This function returns an array and is handled in the same way as the other array functions. Select a range where you want the answers to appear and select the function. Select DataY. Enter any other parameters, mark Array and click OK. +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060108.xhp b/helpcontent2/source/text/scalc/01/04060108.xhp new file mode 100644 index 000000000..4246cc6be --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060108.xhp @@ -0,0 +1,153 @@ + + + + + + + + +Statistics Functions +/text/scalc/01/04060108.xhp + + + +statistics functions +Function Wizard; statistics +functions; statistics functions + +

Statistics Functions

+This category contains the Statistics functions. + +
+ +
+Some of the examples use the following data table: + + + + + +C + + +D + + + + +2 + + +x value + + +y value + + + + +3 + + +-5 + + +-3 + + + + +4 + + +-2 + + +0 + + + + +5 + + +-1 + + +1 + + + + +6 + + +0 + + +3 + + + + +7 + + +2 + + +4 + + + + +8 + + +4 + + +6 + + + + +9 + + +6 + + +8 + + +
+ +The statistical functions are described in the following subsections. + + + + + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060109.xhp b/helpcontent2/source/text/scalc/01/04060109.xhp new file mode 100644 index 000000000..99e061ae0 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060109.xhp @@ -0,0 +1,700 @@ + + + + + + + + + Spreadsheet Functions + /text/scalc/01/04060109.xhp + + + +spreadsheets; functions + Function Wizard; spreadsheets + functions; spreadsheets + +

Spreadsheet Functions

+ This section contains descriptions of the Spreadsheet functions together with an example. +
+ +
+ +
+ADDRESS function + + +

ADDRESS

+ Returns a cell address (reference) as text, according to the specified row and column numbers. You can determine whether the address is interpreted as an absolute address (for example, $A$1) or as a relative address (as A1) or in a mixed form (A$1 or $A1). You can also specify the name of the sheet. +
+ For interoperability the ADDRESS and INDIRECT functions support an optional parameter to specify whether the R1C1 address notation instead of the usual A1 notation should be used. + In ADDRESS, the parameter is inserted as the fourth parameter, shifting the optional sheet name parameter to the fifth position. + In INDIRECT, the parameter is appended as the second parameter. + In both functions, if the argument is inserted with the value 0, then the R1C1 notation is used. If the argument is not given or has a value other than 0, then the A1 notation is used. + In case of R1C1 notation, ADDRESS returns address strings using the exclamation mark '!' as the sheet name separator, and INDIRECT expects the exclamation mark as sheet name separator. Both functions still use the dot '.' sheet name separator with A1 notation. + When opening documents from ODF 1.0/1.1 format, the ADDRESS functions that show a sheet name as the fourth parameter will shift that sheet name to become the fifth parameter. A new fourth parameter with the value 1 will be inserted. + When storing a document in ODF 1.0/1.1 format, if ADDRESS functions have a fourth parameter, that parameter will be removed. + Do not save a spreadsheet in the old ODF 1.0/1.1 format if the ADDRESS function's new fourth parameter was used with a value of 0. + The INDIRECT function is saved without conversion to ODF 1.0/1.1 format. If the second parameter was present, an older version of Calc will return an error for that function. +
+ + ADDRESS(Row; Column [; Abs [; A1 [; "Sheet"]]]) + + Row represents the row number for the cell reference + + Column represents the column number for the cell reference (the number, not the letter) + + Abs determines the type of reference: + 1: absolute ($A$1) + 2: row reference type is absolute; column reference is relative (A$1) + 3: row (relative); column (absolute) ($A1) + 4: relative (A1) + + A1 (optional) - if set to 0, the R1C1 notation is used. If this parameter is absent or set to another value than 0, the A1 notation is used. + + Sheet represents the name of the sheet. It must be placed in double quotes. +

Example:

+ + =ADDRESS(1;1;2;;"Sheet2") returns the following: Sheet2.A$1i 101187 + If the formula above is in cell B2 of current sheet, and the cell A1 in sheet 2 contains the value -6, you can refer indirectly to the referenced cell using a function in B2 by entering =ABS(INDIRECT(B2)). The result is the absolute value of the cell reference specified in B2, which in this case is 6. +
+
+AREAS function + + +

AREAS

+ Returns the number of individual ranges that belong to a multiple range. A range can consist of contiguous cells or a single cell. + The function expects a single argument. If you state multiple ranges, you must enclose them into additional parentheses. Multiple ranges can be entered using the semicolon (;) as divider, but this gets automatically converted to the tilde (~) operator. The tilde is used to join ranges. + + AREAS(Reference) + Reference represents the reference to a cell or cell range. + + + =AREAS((A1:B3;F2;G1)) returns 3, as it is a reference to three cells and/or areas. After entry this gets converted to =AREAS((A1:B3~F2~G1)). + + =AREAS(All) returns 1 if you have defined an area named All under Data - Define Range. +
+
+DDE function + + +

DDE

+ Returns the result of a DDE-based link. If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose Edit - Links to see the updated links. Cross-platform links, for example from a %PRODUCTNAME installation running on a Windows machine to a document created on a Linux machine, are not allowed. + + DDE("Server"; "File"; "Range" [; Mode]) + + Server is the name of a server application. %PRODUCTNAME applications have the server name "soffice". + + File is the complete file name, including path specification. + + Range is the area containing the data to be evaluated. + + Mode is an optional parameter that controls the method by which the DDE server converts its data into numbers. + + + + + Mode + + + + + Effect + + + + + + 0 or missing + + + Number format from the "Default" cell style + + + + + 1 + + + Data are always interpreted in the standard format for US English + + + + + 2 + + + Data are retrieved as text; no conversion to numbers + + +
+ + + + =DDE("soffice";"c:\office\document\data1.ods";"sheet1.A1") reads the contents of cell A1 in sheet1 of the %PRODUCTNAME Calc spreadsheet data1.ods. + + =DDE("soffice";"c:\office\document\motto.odt";"Today's motto") returns a motto in the cell containing this formula. First, you must enter a line in the motto.odt document containing the motto text and define it as the first line of a section named Today's Motto (in %PRODUCTNAME Writer under Insert - Section). If the motto is modified (and saved) in the %PRODUCTNAME Writer document, the motto is updated in all %PRODUCTNAME Calc cells in which this DDE link is defined. +
+
+ERRORTYPE function + + +

ERRORTYPE

+ Returns the number corresponding to an error value occurring in a different cell. With the aid of this number, you can generate an error message text. + + The Status Bar displays the predefined error code from %PRODUCTNAME if you click the cell containing the error. + + ERRORTYPE(Reference) + + Reference contains the address of the cell in which the error occurs. + + If cell A1 displays Err:518, the function =ERRORTYPE(A1) returns the number 518. + + + ORG.OPENOFFICE.ERRORTYPE +
+
+

+ +
+
+INDEX function + + +

INDEX

+ INDEX returns a sub range, specified by row and column number, or an optional range index. Depending on context, INDEX returns a reference or content.UFI: will change with i4904; see http://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i57108changed by i83070 + + INDEX(Reference [; Row [; Column [; Range]]]) + + Reference is a reference, entered either directly or by specifying a range name. If the reference consists of multiple ranges, you must enclose the reference or range name in parentheses. + + Row (optional) represents the row index of the reference range, for which to return a value. In case of zero (no specific row) all referenced rows are returned. + + Column (optional) represents the column index of the reference range, for which to return a value. In case of zero (no specific column) all referenced columns are returned. + + Range (optional) represents the index of the subrange if referring to a multiple range. + + + =INDEX(Prices;4;1) returns the value from row 4 and column 1 of the database range defined in Data - Define as Prices. + + =INDEX(SumX;4;1) returns the value from the range SumX in row 4 and column 1 as defined in Sheet - Named Ranges and Expressions - Define. + + =INDEX(A1:B6;1) returns a reference to the first row of A1:B6. + + =INDEX(A1:B6;0;1) returns a reference to the first column of A1:B6. + + =INDEX((multi);4;1) indicates the value contained in row 4 and column 1 of the (multiple) range, which you named under Sheet - Named Ranges and Expressions - Define as multi. The multiple range may consist of several rectangular ranges, each with a row 4 and column 1. If you now want to call the second block of this multiple range enter the number 2 as the range parameter. + + =INDEX(A1:B6;1;1) indicates the value in the upper-left of the A1:B6 range. + + =INDEX((multi);0;0;2) returns a reference to the second range of the multiple range. +
+
+INDIRECT function + + +

INDIRECT

+ Returns the reference specified by a text string. This function can also be used to return the area of a corresponding string. + + + + INDIRECT(Ref [; A1]) + + Ref represents a reference to a cell or an area (in text form) for which to return the contents. + + A1 (optional) - if set to 0, the R1C1 notation is used. If this parameter is absent or set to another value than 0, the A1 notation is used. + If you open an Excel spreadsheet that uses indirect addresses calculated from string functions, the sheet addresses will not be translated automatically. For example, the Excel address in INDIRECT("[filename]sheetname!"&B1) is not converted into the Calc address in INDIRECT("filename#sheetname."&B1).UFI: for #i34465# + + + =INDIRECT(A1) equals 100 if A1 contains C108 as a reference and cell C108 contains a value of 100. + + =SUM(INDIRECT("a1:" & ADDRESS(1;3))) totals the cells in the area of A1 up to the cell with the address defined by row 1 and column 3. This means that area A1:C1 is totaled. +
+
+COLUMN function + + +

COLUMN

+ Returns the column number of a cell reference. If the reference is a cell the column number of the cell is returned; if the parameter is a cell area, the corresponding column numbers are returned in a single-row array if the formula is entered as an array formula. If the COLUMN function with an area reference parameter is not used for an array formula, only the column number of the first cell within the area is determined. + + COLUMN([Reference]) + + Reference is the reference to a cell or cell area whose first column number is to be found. + If no reference is entered, the column number of the cell in which the formula is entered is found. %PRODUCTNAME Calc automatically sets the reference to the current cell. + + + =COLUMN(A1) equals 1. Column A is the first column in the table. + + =COLUMN(C3:E3) equals 3. Column C is the third column in the table. + + =COLUMN(D3:G10) returns 4 because column D is the fourth column in the table and the COLUMN function is not used as an array formula. (In this case, the first value of the array is always used as the result.) + + {=COLUMN(B2:B7)} and =COLUMN(B2:B7) both return 2 because the reference only contains column B as the second column in the table. Because single-column areas have only one column number, it does not make a difference whether or not the formula is used as an array formula. + + =COLUMN() returns 3 if the formula was entered in column C. + + {=COLUMN(Rabbit)} returns the single-row array (3, 4) if "Rabbit" is the named area (C1:D3). +
+
+COLUMNS function + + +

COLUMNS

+ Returns the number of columns in the given reference. + + COLUMNS(Array) + + Array is the reference to a cell range whose total number of columns is to be found. The argument can also be a single cell. + + + =COLUMNS(B5) returns 1 because a cell only contains one column. + + =COLUMNS(A1:C5) equals 3. The reference comprises three columns. + + =COLUMNS(Rabbit) returns 2 if Rabbit is the named range (C1:D3). +
+
+vertical search function + VLOOKUP function + + +

VLOOKUP

+Vertical search with reference to adjacent cells to the right. This function checks if a specific value is contained in the first column of an array. The function then returns the value in the same row of the column named by Index. If the Sorted parameter is omitted or set to TRUE or one, it is assumed that the data is sorted in ascending order. In this case, if the exact Lookup is not found, the last value that is smaller than the criterion will be returned. If Sorted is set to FALSE or zero, an exact match must be found, otherwise the error Error: Value Not Available will be the result. Thus with a value of zero the data does not need to be sorted in ascending order. + + + =VLOOKUP(Lookup; Array; Index [; SortedRangeLookup]) + + Lookup is the value of any type looked for in the first column of the array. + + Array is the reference, which is to comprise at least as many columns as the number passed in Index argument. + + Index is the number of the column in the array that contains the value to be returned. The first column has the number 1. + + SortedRangeLookup is an optional parameter that indicates whether the first column in the array contains range boundaries instead of plain values. In this mode, the lookup returns the value in the row with first column having value equal to or less than Lookup. E.g., it could contain dates when some tax value had been changed, and so the values represent starting dates of a period when a specific tax value was effective. Thus, searching for a date that is absent in the first array column, but falls between some existing boundary dates, would give the lower of them, allowing to find out the data being effective to the searched date. Enter the Boolean value FALSE or zero if the first column is not a range boundary list. When this parameter is TRUE or not given, the first column in the array must be sorted in ascending order. Sorted columns can be searched much faster and the function always returns a value, even if the search value was not matched exactly, if it is greater than the lowest value of the sorted list. In unsorted lists, the search value must be matched exactly. Otherwise the function will return #N/A with message: Error: Value Not Available. + + + You want to enter the number of a dish on the menu in cell A1, and the name of the dish is to appear as text in the neighboring cell (B1) immediately. The Number to Name assignment is contained in the D1:E100 array. D1 contains 100, E1 contains the name Vegetable Soup, and so forth, for 100 menu items. The numbers in column D are sorted in ascending order; thus, the optional Sorted parameter is not necessary. + Enter the following formula in B1: + + =VLOOKUP(A1;D1:E100;2) + + As soon as you enter a number in A1 B1 will show the corresponding text contained in the second column of reference D1:E100. Entering a nonexistent number displays the text with the next number down. To prevent this, enter FALSE as the last parameter in the formula so that an error message is generated when a nonexistent number is entered. +
+
+sheet numbers; looking up + SHEET function + + +

SHEET

+ Returns the sheet number of either a reference or a string representing a sheet name. If you do not enter any parameters, the result is the sheet number of the spreadsheet containing the formula. + + SHEET([Reference]) + + Reference is optional and is the reference to a cell, an area, or a sheet name string. + + + =SHEET(Sheet2.A1) returns 2 if Sheet2 is the second sheet in the spreadsheet document. + + =SHEET("Sheet3") returns 3 if Sheet3 is the third sheet in the spreadsheet document. +
+
+number of sheets; function + SHEETS function + + +

SHEETS

+ Determines the number of sheets in a reference. If you do not enter any parameters, it returns the number of sheets in the current document. + + SHEETS([Reference]) + + Reference is the reference to a sheet or an area. This parameter is optional. + + + =SHEETS(Sheet1.A1:Sheet3.G12) returns 3 if Sheet1, Sheet2, and Sheet3 exist in the sequence indicated. +
+
+MATCH function + + +

MATCH

+ Returns the relative position of an item in an array that matches a specified value. The function returns the position of the value found in the lookup_array as a number. + + MATCH(Search; LookupArray [; Type]) + + Search is the value which is to be searched for in the single-row or single-column array. + + LookupArray is the reference searched. A lookup array can be a single row or column, or part of a single row or column. + + Type may take the values 1, 0, or -1. If Type = 1 or if this optional parameter is missing, it is assumed that the first column of the search array is sorted in ascending order. If Type = -1 it is assumed that the column in sorted in descending order. This corresponds to the same function in Microsoft Excel. + If Type = 0, only exact matches are found. If the search criterion is found more than once, the function returns the index of the first matching value. Only if Type = 0 can you search for regular expressions (if enabled in calculation options) or wildcards (if enabled in calculation options). + If Type = 1 or the third parameter is missing, the index of the last value that is smaller or equal to the search criterion is returned. For Type = -1, the index of the last value that is larger or equal is returned. + + + + =MATCH(200;D1:D100) searches the area D1:D100, which is sorted by column D, for the value 200. As soon as this value is reached, the number of the row in which it was found is returned. If a higher value is found during the search in the column, the number of the previous row is returned. +
+
+OFFSET function + + +

OFFSET

+ Returns the value of a cell offset by a certain number of rows and columns from a given reference point. + + + OFFSET(Reference; Rows; Columns [; Height [; Width]]) + + Reference is the reference from which the function searches for the new reference. + + Rows is the number of rows by which the reference was corrected up (negative value) or down. Use 0 to stay in the same row. + + Columns is the number of columns by which the reference was corrected to the left (negative value) or to the right. Use 0 to stay in the same column + + Height (optional) is the vertical height for an area that starts at the new reference position. + + Width (optional) is the horizontal width for an area that starts at the new reference position. + Arguments Rows and Columns must not lead to zero or negative start row or column. + Arguments Height and Width must not lead to zero or negative count of rows or columns. + + + + + + =OFFSET(A1;2;2) returns the value in cell C3 (A1 moved by two rows and two columns down). If C3 contains the value 100 this function returns the value 100. + + =OFFSET(B2:C3;1;1) returns a reference to B2:C3 moved down by 1 row and one column to the right (C3:D4). + + =OFFSET(B2:C3;-1;-1) returns a reference to B2:C3 moved up by 1 row and one column to the left (A1:B2). + + =OFFSET(B2:C3;0;0;3;4) returns a reference to B2:C3 resized to 3 rows and 4 columns (B2:E4). + + =OFFSET(B2:C3;1;0;3;4) returns a reference to B2:C3 moved down by one row resized to 3 rows and 4 columns (B3:E5). + + =SUM(OFFSET(A1;2;2;5;6)) determines the total of the area that starts in cell C3 and has a height of 5 rows and a width of 6 columns (area=C3:H7). + If Width or Height are given, the OFFSET function returns a cell range reference. If Reference is a single cell reference and both Width and Height are omitted, a single cell reference is returned. +
+
+LOOKUP function + + +

LOOKUP

+ Returns the contents of a cell either from a one-row or one-column range. Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to VLOOKUP and HLOOKUP, search and result vector may be at different positions; they do not have to be adjacent. Additionally, the search vector for the LOOKUP must be sorted ascending, otherwise the search will not return any usable results. + If LOOKUP cannot find the search criterion, it matches the largest value in the search vector that is less than or equal to the search criterion. + + + LOOKUP(Lookup; SearchVector [; ResultVector]) + + Lookup is the value of any type to be looked for; entered either directly or as a reference. + + SearchVector is the single-row or single-column area to be searched. + + ResultVector is another single-row or single-column range from which the result of the function is taken. The result is the cell of the result vector with the same index as the instance found in the search vector. + + + + =LOOKUP(A1;D1:D100;F1:F100) searches the corresponding cell in range D1:D100 for the number you entered in A1. For the instance found, the index is determined, for example, the 12th cell in this range. Then, the contents of the 12th cell are returned as the value of the function (in the result vector). +
+
+STYLE function + + +

STYLE

+ Applies a style to the cell containing the formula. After a set amount of time, another style can be applied. This function always returns the value 0, allowing you to add it to another function without changing the value. Together with the CURRENT function you can apply a color to a cell depending on the value. For example: =...+STYLE(IF(CURRENT()>3;"red";"green")) applies the style "red" to the cell if the value is greater than 3, otherwise the style "green" is applied. Both cell formats, "red" and "green" have to be defined beforehand. + + STYLE("Style" [; Time [; "Style2"]]) + + Style is the name of a cell style assigned to the cell. Style names must be entered in quotation marks. + + Time is an optional time range in seconds. If this parameter is missing the style will not be changed after a certain amount of time has passed. + + Style2 is the optional name of a cell style assigned to the cell after a certain amount of time has passed. If this parameter is missing "Default" is assumed. + + + + + + =STYLE("Invisible";60;"Default") formats the cell in transparent format for 60 seconds after the document was recalculated or loaded, then the Default format is assigned. Both cell formats have to be defined beforehand. + Since STYLE() has a numeric return value of zero, this return value gets appended to a string. This can be avoided using T() as in the following example: + + ="Text"&T(STYLE("myStyle")) + + See also CURRENT() for another example. + + + ORG.OPENOFFICE.STYLE +
+
+CHOOSE function + + +

CHOOSE

+ Uses an index to return a value from a list of up to 30 values. + + CHOOSE(Index; Value 1 [; Value 2 [; ... [; Value 30]]]) + + Index is a reference or number between 1 and 30 indicating which value is to be taken from the list. + + Value 1, Value 2, ..., Value 30 is the list of values entered as a reference to a cell or as individual values. + + + =CHOOSE(A1;B1;B2;B3;"Today";"Yesterday";"Tomorrow"), for example, returns the contents of cell B2 for A1 = 2; for A1 = 4, the function returns the text "Today". +
+
+HLOOKUP function + + +

HLOOKUP

+ Searches for a value and reference to the cells below the selected area. This function verifies if the first row of an array contains a certain value. The function returns then the value in a row of the array, named in the Index, in the same column. + + + HLOOKUP(Lookup; Array; Index [; SortedRangeLookup]) + For an explanation on the parameters, see: VLOOKUP (columns and rows are exchanged) + + + Suppose we have built a small database table occupying the cell range A1:DO4 and containing basic information about 118 chemical elements. The first column contains the row headings “Element”, “Symbol”, “Atomic Number”, and “Relative Atomic Mass”. Subsequent columns contain the relevant information for each of the elements, ordered left to right by atomic number. For example, cells B1:B4 contain “Hydrogen”, “H”, “1” and “1.008”, while cells DO1:DO4 contain “Oganesson”, “Og”, “118”, and “294”. + + + + + + + A + + + B + + + C + + + D + + + ... + + + DO + + + + + 1 + + + Element + + + Hydrogen + + + Helium + + + Lithium + + + ... + + + Oganesson + + + + + 2 + + + Symbol + + + H + + + He + + + Li + + + ... + + + Og + + + + + 3 + + + Atomic Number + + + 1 + + + 2 + + + 3 + + + ... + + + 118 + + + + + 4 + + + Relative Atomic Mass + + + 1.008 + + + 4.0026 + + + 6.94 + + + ... + + + 294 + + +
+ =HLOOKUP("Lead"; $A$1:$DO$4; 2; 0) returns “Pb”, the symbol for lead. + =HLOOKUP("Gold"; $A$1:$DO$4; 3; 0) returns 79, the atomic number for gold. + =HLOOKUP("Carbon"; $A$1:$DO$4; 4; 0) returns 12.011, the relative atomic mass of carbon. +
+
+ROW function + + +

ROW

+ Returns the row number of a cell reference. If the reference is a cell, it returns the row number of the cell. If the reference is a cell range, it returns the corresponding row numbers in a one-column Array if the formula is entered as an array formula. If the ROW function with a range reference is not used in an array formula, only the row number of the first range cell will be returned. + + ROW([Reference]) + + Reference is a cell, an area, or the name of an area. + If you do not indicate a reference, the row number of the cell in which the formula is entered will be found. %PRODUCTNAME Calc automatically sets the reference to the current cell. + + + =ROW(B3) returns 3 because the reference refers to the third row in the table. + + {=ROW(D5:D8)} returns the single-column array (5, 6, 7, 8) because the reference specified contains rows 5 through 8. + + =ROW(D5:D8) returns 5 because the ROW function is not used as array formula and only the number of the first row of the reference is returned. + + {=ROW(A1:E1)} and =ROW(A1:E1) both return 1 because the reference only contains row 1 as the first row in the table. (Because single-row areas only have one row number it does not make any difference whether or not the formula is used as an array formula.) + + =ROW() returns 3 if the formula was entered in row 3. + + {=ROW(Rabbit)} returns the single-column array (1, 2, 3) if "Rabbit" is the named area (C1:D3). +
+
+ROWS function + + +

ROWS

+ Returns the number of rows in a reference or array. + + ROWS(Array) + + Array is the reference or named area whose total number of rows is to be determined. + + + =Rows(B5) returns 1 because a cell only contains one row. + + =ROWS(A10:B12) returns 3. + + =ROWS(Rabbit) returns 3 if "Rabbit" is the named area (C1:D3). +
+
+ +HYPERLINK function + +

HYPERLINK

+ When you click a cell that contains the HYPERLINK function, the hyperlink opens. + If you use the optional CellValue parameter, the formula locates the URL, and then displays the text or number. + To open a hyperlinked cell with the keyboard, select the cell, press F2 to enter the Edit mode, move the cursor in front of the hyperlink, press Shift+F10, and then choose Open Hyperlink. + + HYPERLINK("URL" [; CellValue]) + + URL specifies the link target. The optional CellValue parameter is the text or a number that is displayed in the cell and will be returned as the result. If the CellValue parameter is not specified, the URL is displayed in the cell text and will be returned as the result. + The number 0 is returned for empty cells and matrix elements. + + + =HYPERLINK("http://www.example.org") displays the text "http://www.example.org" in the cell and executes the hyperlink http://www.example.org when clicked. + + =HYPERLINK("http://www.example.org";"Click here") displays the text "Click here" in the cell and executes the hyperlink http://www.example.org when clicked. + + =HYPERLINK("http://www.example.org";12345) displays the number 12345 and executes the hyperlink http://www.example.org when clicked. + + =HYPERLINK($B4) where cell B4 contains http://www.example.org. The function adds http://www.example.org to the URL of the hyperlink cell and returns the same text which is used as formula result. + + =HYPERLINK("http://www.";"Click ") & "example.org" displays the text Click example.org in the cell and executes the hyperlink http://www.example.org when clicked. + + =HYPERLINK("#Sheet1.A1";"Go to top") displays the text Go to top and jumps to cell Sheet1.A1 in this document. + + =HYPERLINK("file:///C:/writer.odt#Specification";"Go to Writer bookmark") displays the text "Go to Writer bookmark", loads the specified text document and jumps to bookmark "Specification". + + =HYPERLINK("file:///C:/Documents/";"Open Documents folder") displays the text "Open Documents folder" and shows the folder contents using the standard file manager in your operating system. +
+
+GETPIVOTDATA function + + +

GETPIVOTDATA

+ The GETPIVOTDATA function returns a result value from a pivot table. The value is addressed using field and item names, so it remains valid if the layout of the pivot table changes. + + Two different syntax definitions can be used: + GETPIVOTDATA(TargetField; pivot table[; Field 1; Item 1][; ... [Field 126; Item 126]]) + or + GETPIVOTDATA(pivot table; Constraints) + The second syntax is assumed if exactly two parameters are given, of which the first parameter is a cell or cell range reference. The first syntax is assumed in all other cases. The Function Wizard shows the first syntax. +

First Syntax

+ + TargetField is a string that selects one of the pivot table's data fields. The string can be the name of the source column, or the data field name as shown in the table (like "Sum - Sales"). + + pivot table is a reference to a cell or cell range that is positioned within a pivot table or contains a pivot table. If the cell range contains several pivot tables, the table that was created last is used. + If no Field n / Item n pairs are given, the grand total is returned. Otherwise, each pair adds a constraint that the result must satisfy. Field n is the name of a field from the pivot table. Item n is the name of an item from that field. + If the pivot table contains only a single result value that fulfills all of the constraints, or a subtotal result that summarizes all matching values, that result is returned. If there is no matching result, or several ones without a subtotal for them, an error is returned. These conditions apply to results that are included in the pivot table. + If the source data contains entries that are hidden by settings of the pivot table, they are ignored. The order of the Field/Item pairs is not significant. Field and item names are not case-sensitive. + If no constraint for a filter is given, the field's selected value is implicitly used. If a constraint for a filter is given, it must match the field's selected value, or an error is returned. Filters are the fields at the top left of a pivot table, populated using the "Filters" area of the pivot table layout dialog. From each filter, an item (value) can be selected, which means only that item is included in the calculation. + Subtotal values from the pivot table are only used if they use the function "auto" (except when specified in the constraint, see Second Syntax below). +

Second Syntax

+ pivot table has the same meaning as in the first syntax. + Constraints is a space-separated list. Entries can be quoted (single quotes). The whole string must be enclosed in quotes (double quotes), unless you reference the string from another cell. + One of the entries can be the data field name. The data field name can be left out if the pivot table contains only one data field, otherwise it must be present. + Each of the other entries specifies a constraint in the form Field[Item] (with literal characters [ and ]), or only Item if the item name is unique within all fields that are used in the pivot table.i82342 + A function name can be added in the form Field[Item;Function], which will cause the constraint to match only subtotal values which use that function. The possible function names are Sum, Count, Average, Max, Min, Product, Count (Numbers only), StDev (Sample), StDevP (Population), Var (Sample), and VarP (Population), case-insensitive.UFI: Example from spec doc is quite difficult to localize. Try to find other one +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060110.xhp b/helpcontent2/source/text/scalc/01/04060110.xhp new file mode 100644 index 000000000..d4a9c0016 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060110.xhp @@ -0,0 +1,759 @@ + + + + + + + Text Functions + /text/scalc/01/04060110.xhp + + + + + + + text in cells; functions + functions; text functions + Function Wizard;text + + + +

Text Functions

+This section contains descriptions of the Text functions. + +
+ +
+ +
+ + using double quotation marks in formulas + formulas; using double quotation marks + + +

Using double quotation marks in formulas

+ +To include a text string in a formula, place the text string between two double quotation marks (") and Calc takes the characters in the string without attempting to interpret them. For example, the formula ="Hello world!" displays the text string Hello world! in the cell, with no surrounding double quotation marks. + +The more complex formula =CONCATENATE("Life is really simple, "; "but we insist on making it complicated "; "(Confucius).") concatenates three individual strings in double quotation marks, outputting Life is really simple, but we insist on making it complicated (Confucius). + +To place a literal double quotation mark within a string inside a formula, two methods can be used: + + + + You can "escape" the double quotation mark with an additional double quotation mark, and Calc treats the escaped double quotation mark as a literal value. For example, the formula ="My name is ""John Doe""." outputs the string My name is "John Doe". Another simple example is the formula =UNICODE("""") which returns 34, the decimal value of the Unicode quotation mark character (U+0022) — here the first and fourth double quotation marks indicate the beginning and end of the string, while the second double quotation mark escapes the third. + + + You can use the CHAR function or the UNICHAR function to insert a double quotation mark. For example, the formula =UNICHAR(34) & "The Catcher in the Rye" & UNICHAR(34) & " is a famous book by J. D. Salinger." displays the string "The Catcher in the Rye" is a famous book by J. D. Salinger. + + + +Beware that Calc's AutoCorrect function may modify double quotation marks. AutoCorrect should not change the double quotation marks within formula cells but may change those used in non-formula cells containing text. For example, if you copy a string that is surrounded by some other form of typographical double quotation marks, such as the left double quotation mark (U+201C) and the right double quotation mark (U+201D), and then paste into a formula cell, an error may result. Open the Double Quotes area of the Tools - AutoCorrect Options - Localized Options dialog to set the characters used to automatically correct the start and end typographical double quotation marks. Uncheck the Replace toggle button to disable the feature. + +
+ + + +
+ +
+ +
+ +
+ +
+ + BAHTTEXT function + +i66350 +

BAHTTEXT

+Converts a number to Thai text, including the Thai currency names. + + +BAHTTEXT(Number) + Number is any number. "Baht" is appended to the integral part of the number, and "Satang" is appended to the decimal part of the number. + + + =BAHTTEXT(12.65) returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang". + + + COM.MICROSOFT.BAHTTEXT +
+ +
+ + BASE function + + + + + decimal system; converting to + +

BASE

+Converts a positive integer to a specified base into a text from the numbering system. The digits 0-9 and the letters A-Z are used. + + +BASE(Number; Radix [; MinimumLength]) + Number is the positive integer to be converted. + Radix indicates the base of the numeral system. It may be any positive integer between 2 and 36. + MinimumLength (optional) determines the minimum length of the character sequence that has been created. If the text is shorter than the indicated minimum length, zeros are added to the left of the string. + + + =BASE(17;10;4) returns 0017 in the decimal system. + + binary system; converting to + + + =BASE(17;2) returns 10001 in the binary system. + + hexadecimal system; converting to + + + =BASE(255;16;4) returns 00FF in the hexadecimal system. + + +DECIMAL +
+ +
+ + CHAR function + + + + +

CHAR

+Converts a number into a character according to the current code table. The number can be a two-digit or three-digit integer number. + + + +CHAR(Number) + Number is a number between 1 and 255 representing the code value for the character. + + + =CHAR(100) returns the character d. +="abc" & CHAR(10) & "def" inserts a newline character into the string. +
+ +
+ + CLEAN function + + + + +

CLEAN

+All non-printing characters are removed from the string. + + +CLEAN("Text") + Text refers to the text from which to remove all non-printable characters. + + +=LEN(CLEAN(CHAR(7) & "LibreOffice Calc" & CHAR(8))) returns 16, showing that the CLEAN function removes the non-printable Unicode U+0007 ("BEL") and U+0008 ("BS") characters at the beginning and end of the string argument. CLEAN does not remove spaces. + +
+ +
+ + CODE function + + + + +

CODE

+Returns a numeric code for the first character in a text string. + + +CODE("Text") + Text is the text for which the code of the first character is to be found. + + + + =CODE("Hieronymus") returns 72, =CODE("hieroglyphic") returns 104. +The code used here does not refer to ASCII, but to the code table currently loaded. +
+ +
+ + CONCATENATE function + + +

CONCATENATE

+Combines several text strings into one string. + +CONCATENATE() +String 1[; String 2][; … ;[String 255]] are strings or references to cells containing strings. + + =CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe") returns: Good Morning Mrs. Doe. +
+ +
+ + DECIMAL function + + + + +

DECIMAL

+Converts text that represents a number in a numeral system with the given base radix to a positive integer. The radix must be in the range 2 to 36. Spaces and tabs are ignored. The Text field is not case-sensitive. +If the radix is 16, a leading x or X or 0x or 0X, and an appended h or H, are disregarded. If the radix is 2, an appended b or B is disregarded. Other characters that do not belong to the numeral system generate an error. + + +DECIMAL("Text"; Radix) + Text is the text to be converted. + Radix indicates the base of the numeral system. It may be any positive integer between 2 and 36. + + + =DECIMAL("17";10) returns 17. + =DECIMAL("FACE";16) returns 64206. + =DECIMAL("0101";2) returns 5. + +BASE +
+ +
+ + DOLLAR function + + + + +

DOLLAR

+Converts a number to a string representing the amount in the currency format, rounded to a specified decimal places, using the decimal separator that corresponds to the current locale setting. In the Value field enter the number to be converted. Optionally, you may enter the number of decimal places in the Decimals field. If no value is specified, all numbers in currency format will be displayed with two decimal places. +You set the currency format in your system settings. + + +DOLLAR(Value [; Decimals]) + Value is a number, a reference to a cell containing a number, or a formula which returns a number. + Decimals is the optional number of decimal places. + + + =DOLLAR(255) returns $255.00 for the English (USA) locale and USD (dollar) currency; ￥255.00 for the Japanese locale and JPY (yen) currency; or 255,00 € for the German (Germany) locale and EUR (euro) currency. + =DOLLAR(367.456;2) returns $367.46. +
+ +
+ + EXACT function + + + + +

EXACT

+Compares two text strings and returns TRUE if they are identical. This function is case-sensitive. + + +EXACT("Text1"; "Text2") + Text1 refers to the first text to compare. + Text2 is the second text to compare. + + + =EXACT("microsystems";"Microsystems") returns FALSE. +
+ +
+ + FIND function + + + + +

FIND

+Returns the position of a string of text within another string.You can also define where to begin the search. The search term can be a number or any string of characters. The search is case-sensitive. + + +FIND("FindText"; "Text" [; Position]) + FindText refers to the text to be found. + Text is the text where the search takes place. + Position (optional) is the position in the text from which the search starts. + + + =FIND(76;998877665544) returns 6. +
+ +
+ + FIXED function + + + + +

FIXED

+Returns a number as text with a specified number of decimal places and optional thousands separators. + + +FIXED(Number; [Decimals = 2 [; NoThousandsSeparators = FALSE]]) + + Number is rounded to Decimals places (after the decimal separator) and the result formatted as text, using locale-specific settings. + Decimals (optional) refers to the number of decimal places to be displayed. If Decimals is negative, Number is rounded to ABS(Decimals) places to the left from the decimal point. If Decimals is a fraction, it is truncated actually ignoring what is the closest integer. + NoThousandsSeparators (optional) determines whether the thousands separator is used. If it is TRUE or non-zero, then group separators are omitted from the resulting string. If the parameter is equal to 0 or if it is missing altogether, the thousands separators of your current locale setting are displayed. + + + =FIXED(1234567.89;3) returns 1,234,567.890 as a text string. + =FIXED(123456.789;;TRUE) returns 123456.79 as a text string. + =FIXED(12345.6789;-2) returns 12,300 as a text string. + =FIXED(12134567.89;-3;1) returns 12135000 as a text string. + =FIXED(12345.789;3/4) returns 12,346 as a text string. + =FIXED(12345.789;8/5) returns 12,345.8 as a text string. +
+ +
+ +
+ +
+ + LEFT function + + + + +

LEFT

+Returns the first character or characters of a text. + + +LEFT("Text" [; Number]) + Text is the text where the initial partial words are to be determined. + Number (optional) specifies the number of characters for the start text. If this parameter is not defined, one character is returned. + + + =LEFT("output";3) returns “out”. +
+ +
+ + LEFTB function + + + + +

LEFTB

+Returns the first characters of a DBCS text. + + +LEFTB("Text" [; Number_bytes]) +Text is the text where the initial partial words are to be determined. +Number_bytes (optional) specifies the number of characters you want LEFTB to extract, based on bytes. If this parameter is not defined, one character is returned. + + +=LEFTB("中国";1) returns " " (1 byte is only half a DBCS character and a space character is returned instead). +=LEFTB("中国";2) returns "中" (2 bytes constitute one complete DBCS character). +=LEFTB("中国";3) returns "中 " (3 bytes constitute one DBCS character and a half; the last character returned is therefore a space character). +=LEFTB("中国";4) returns "中国" (4 bytes constitute two complete DBCS characters). +=LEFTB("office";3) returns "off" (3 non-DBCS characters each consisting of 1 byte). +
+ +
+ + LEN function + + + + +

LEN

+Returns the length of a string including spaces. + + +LEN("Text") + Text is the text whose length is to be determined. + + + =LEN("Good Afternoon") returns 14. + =LEN(12345.67) returns 8. +
+ +
+ + LENB function + + + + +

LENB

+For double-byte character set (DBCS) languages, returns the number of bytes used to represent the characters in a text string. + + +LENB("Text") +Text is the text whose length is to be determined. + + +LENB("中") returns 2 (1 DBCS character consisting of 2 bytes). +LENB("中国") returns 4 (2 DBCS characters each consisting of 2 bytes). +LENB("office") returns 6 (6 non-DBCS characters each consisting of 1 byte). + =LENB("Good Afternoon") returns 14. + =LENB(12345.67) returns 8. +
+ +
+ + LOWER function + + + + +

LOWER

+Converts all uppercase letters in a text string to lowercase. + + +LOWER("Text") + Text refers to the text to be converted. + + + =LOWER("Sun") returns sun. +
+ +
+ + MID function + + + + +

MID

+Returns a text string of a text. The parameters specify the starting position and the number of characters. + + +MID("Text"; Start; Number) + Text is the text containing the characters to extract. + Start is the position of the first character in the text to extract. + Number specifies the number of characters in the part of the text. + + + =MID("office";2;2) returns ff. +
+ +
+ + MIDB function + + + + +

MIDB

+Returns a text string of a DBCS text. The parameters specify the starting position and the number of characters. + + +MIDB("Text"; Start; Number_bytes) +Text is the text containing the characters to extract. +Start is the position of the first character in the text to extract. +Number_bytes specifies the number of characters MIDB will return from text, in bytes. + + +=MIDB("中国";1;0) returns "" (0 bytes is always an empty string). +=MIDB("中国";1;1) returns " " (1 byte is only half a DBCS character and therefore the result is a space character). +=MIDB("中国";1;2) returns "中" (2 bytes constitute one complete DBCS character). +=MIDB("中国";1;3) returns "中 " (3 bytes constitute one and a half DBCS character; the last byte results in a space character). +=MIDB("中国";1;4) returns "中国" (4 bytes constitute two complete DBCS characters). +=MIDB("中国";2;1) returns " " (byte position 2 is not at the beginning of a character in a DBCS string; 1 space character is returned). +=MIDB("中国";2;2) returns " " (byte position 2 points to the last half of the first character in the DBCS string; the 2 bytes asked for therefore constitutes the last half of the first character and the first half of the second character in the string; 2 space characters are therefore returned). +=MIDB("中国";2;3) returns " 国" (byte position 2 is not at the beginning of a character in a DBCS string; a space character is returned for byte position 2). +=MIDB("中国";3;1) returns " " (byte position 3 is at the beginning of a character in a DBCS string, but 1 byte is only half a DBCS character and a space character is therefore returned instead). +=MIDB("中国";3;2) returns "国" (byte position 3 is at the beginning of a character in a DBCS string, and 2 bytes constitute one DBCS character). +=MIDB("office";2;3) returns "ffi" (byte position 2 is at the beginning of a character in a non-DBCS string, and 3 bytes of a non-DBCS string constitute 3 characters). +
+ +
+ + PROPER function + + + + +

PROPER

+Capitalizes the first letter in all words of a text string. + + +PROPER("Text") + Text refers to the text to be converted. + + + =PROPER("the document foundation") returns The Document Foundation. +
+ +
+ +
+ +
+ + REPLACE function + + + + +

REPLACE

+Replaces part of a text string with a different text string. This function can be used to replace both characters and numbers (which are automatically converted to text). The result of the function is always displayed as text. If you intend to perform further calculations with a number which has been replaced by text, you will need to convert it back to a number using the VALUE function. +Any text containing numbers must be enclosed in quotation marks if you do not want it to be interpreted as a number and automatically converted to text. + + +REPLACE("Text"; Position; Length; "NewText") + Text refers to text of which a part will be replaced. + Position refers to the position within the text where the replacement will begin. + Length is the number of characters in Text to be replaced. + NewText refers to the text which replaces Text. + + + =REPLACE("1234567";1;1;"444") returns "444234567". One character at position 1 is replaced by the complete NewText. +
+ +
+ + REPT function + + + + +

REPT

+Repeats a character string by the given number of copies. + + +REPT("Text"; Number) + Text is the text to be repeated. + Number is the number of repetitions. + + + =REPT("Good morning";2) returns Good morningGood morning. + +Refer to the REPT wiki page for more details about this function.
+ + + +
+ + RIGHTB function + + + + +

RIGHTB

+Returns the last character or characters of a text with double bytes characters sets (DBCS). + + +RIGHTB("Text" [; Number_bytes]) +Text is the text of which the right part is to be determined. +Number_bytes (optional) specifies the number of characters you want RIGHTB to extract, based on bytes. If this parameter is not defined, one byte is returned. + + +RIGHTB("中国";1) returns " " (1 byte is only half a DBCS character and a space character is returned instead). +RIGHTB("中国";2) returns "国" (2 bytes constitute one complete DBCS character). +RIGHTB("中国";3) returns " 国" (3 bytes constitute one half DBCS character and one whole DBCS character; a space is returned for the first half). +RIGHTB("中国";4) returns "中国" (4 bytes constitute two complete DBCS characters). +RIGHTB("office";3) returns "ice" (3 non-DBCS characters each consisting of 1 byte). +
+ +
+ +
+ + + +
+ + SUBSTITUTE function + + + + +

SUBSTITUTE

+Substitutes new text for old text in a string. + + +SUBSTITUTE("Text"; "SearchText"; "NewText" [; Occurrence]) + Text is the text in which text segments are to be exchanged. + SearchText is the text segment that is to be replaced (a number of times). + NewText is the text that is to replace the text segment. + Occurrence (optional) indicates which occurrence of the search text is to be replaced. If this parameter is missing the search text is replaced throughout. + + + =SUBSTITUTE("123123123";"3";"abc") returns 12abc12abc12abc. + =SUBSTITUTE("123123123";"3";"abc";2) returns 12312abc123. +
+ +
+ + T function + + + + +

T

+This function returns the target text, or a blank text string if the target is not text. + + +T(Value) +If Value is a text string or refers to a text string, T returns that text string; otherwise it returns a blank text string. + + + =T(12345) returns an empty string. + =T("12345") returns the string 12345. +
+ +
+ + TEXT function + + + + +

TEXT

+Converts a value into text according to a given format. + + +TEXT(Value; Format) + Value is the value (numerical or textual) to be converted. + Format is the text which defines the format. Use decimal and thousands separators according to the language set in the cell format. + + + =TEXT(12.34567;"###.##") returns the text 12.35 + =TEXT(12.34567;"000.00") returns the text 012.35 + =TEXT("xyz";"=== @ ===") returns the text === xyz === + +See also Number format codes: custom format codes defined by the user. +
+ +
+ + TRIM function + + + + +

TRIM

+Removes spaces from a string, leaving only a single space character between words. + + +TRIM("Text") + Text refers to text in which spaces are to be removed. + + + =TRIM(" hello world ") returns hello world without leading and trailing spaces and with single space between words. +
+ +
+ + + UNICHAR function + + + +

UNICHAR

+Converts a code number into a Unicode character or letter. + + +UNICHAR(number) + + +=UNICHAR(169) returns the Copyright character ©. +See also the UNICODE() function. +
+ +
+ + + UNICODE function + + + +

UNICODE

+Returns the numeric code for the first Unicode character in a text string. + + +UNICODE("Text") + + +=UNICODE("©") returns the Unicode number 169 for the Copyright character. +See also the UNICHAR() function. +
+ +
+ + UPPER function + + + + +

UPPER

+Converts the string specified in the text field to uppercase. + + +UPPER("Text") + Text refers to the lower case letters you want to convert to upper case. + + + =UPPER("Good Morning") returns GOOD MORNING. +
+ +
+ +
+ +
+ +
+
+ +
+
+ +
+ + +
+ +
+ + + diff --git a/helpcontent2/source/text/scalc/01/04060111.xhp b/helpcontent2/source/text/scalc/01/04060111.xhp new file mode 100644 index 000000000..d50288c05 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060111.xhp @@ -0,0 +1,204 @@ + + + + + + + +Add-in Functions +/text/scalc/01/04060111.xhp + + + +add-ins; functions +functions; add-in functions +Function Wizard; add-ins + +

Add-in Functions

+The following describes and lists some of the available add-in functions. + +Add-in concept +You will also find a description of the $[officename] Calc add-in interface in the Help. In addition, important functions and their parameters are described in the Help for the Shared Library +$[officename] Calc add-in DLL. +

Add-ins supplied

+$[officename] contains examples for the add-in interface of $[officename] Calc. +Analysis Functions Part One +Analysis Functions Part Two + +
+ISLEAPYEAR function +leap year determination +mw added one entry +

ISLEAPYEAR

+Determines whether a year is a leap year. If yes, the function will return the value 1 (TRUE); if not, it will return 0 (FALSE). + +ISLEAPYEAR(Date) + +Date specifies whether a given date falls within a leap year. The Date parameter must be a valid date. + +=ISLEAPYEAR(A1) returns 1, if A1 contains 1968-02-29, the valid date 29th of February 1968 in your locale setting. +You may also use =ISLEAPYEAR(DATE(1968;2;29)) or =ISLEAPYEAR("1968-02-29") giving the date string in the ISO 8601 notation. +Never use =ISLEAPYEAR(2/29/68), because this would first evaluate 2 divided by 29 divided by 68, and then calculate the ISLEAPYEAR function from this small number as a serial date number. + + +ORG.OPENOFFICE.ISLEAPYEAR +
+
+YEARS function +number of years between two dates +mw added one entry + +

YEARS

+Calculates the difference in years between two dates. + +YEARS(StartDate; EndDate; Type) + +StartDate is the first date + +EndDate is the second date + +Type calculates the type of difference. Possible values are 0 (interval) and 1 (in calendar years). + + +ORG.OPENOFFICE.YEARS +
+
+MONTHS function +number of months between two dates +mw added one entry + +

MONTHS

+Calculates the difference in months between two dates. + +MONTHS(StartDate; EndDate; Type) + +StartDate is the first date + +EndDate is the second date + +Type calculates the type of difference. Possible values include 0 (interval) and 1 (in calendar months). + + +ORG.OPENOFFICE.MONTHS +
+
+ROT13 function +encrypting text +mw added one entry + +

ROT13

+Encrypts a character string by moving the characters 13 positions in the alphabet. After the letter Z, the alphabet begins again (Rotation). By applying the encryption function again to the resulting code, you can decrypt the text. + +ROT13(Text) + +Text is the character string to be encrypted. ROT13(ROT13(Text)) decrypts the code. + +=ROT13("Gur Qbphzrag Sbhaqngvba jnf sbhaqrq va Frcgrzore 2010.") returns the string "The Document Foundation was founded in September 2010.". Notice how spaces, digits, and full stops are unaffected by ROT13. + + +ORG.OPENOFFICE.ROT13 +Refer to the ROT13 wiki page for more details about this function. +
+
+DAYSINYEAR function +number of days; in a specific year +mw added one entry + +

DAYSINYEAR

+Calculates the number of days of the year in which the date entered occurs. + +DAYSINYEAR(Date) + +Date is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME. + +=DAYSINYEAR(A1) returns 366 days if A1 contains 1968-02-29, a valid date for the year 1968. + + +ORG.OPENOFFICE.DAYSINYEAR +
+
+DAYSINMONTH function +number of days;in a specific month of a year +mw added one entry + +

DAYSINMONTH

+Calculates the number of days of the month in which the date entered occurs. + +DAYSINMONTH(Date) + +Date is any date in the respective month of the desired year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME. + +=DAYSINMONTH(A1) returns 29 days if A1 contains 1968-02-17, a valid date for February 1968. + + +ORG.OPENOFFICE.DAYSINMONTH +
+
+WEEKS function +number of weeks;between two dates + + +

WEEKS

+Calculates the difference in weeks between two dates. + +WEEKS(StartDate; EndDate; Type) + +StartDate is the start date in the interval. + +EndDate is the end date in the interval. The end date must be greater than the start date, or else an error is returned. + +Type specifies the type of difference to be calculated. Possible values are 0 (time interval) or 1 (calendar weeks). +If Type = 0 the function will assume that 7 days is equivalent to one week without considering any specific day to mark the beginning of a week. +If Type = 1 the function will consider Monday to be the first day of the week. Therefore, except for the start date, each occurrence of a Monday in the interval is counted as an additional week. +This function considers Monday to be the first day of the week regardless of the current locale settings. + +In the following examples, dates are passed as strings. However, they can also be stored in separate cells and be passed as references. +=WEEKS("01/12/2022","01/17/2022",0) returns 0 because Type was set to 0 and there are only 5 days in the interval. +=WEEKS("01/12/2022","01/19/2022",0) returns 1 because Type was set to 0 and there are 7 days in the interval. +=WEEKS("01/12/2022","01/17/2022",1) returns 1 because Type was set to 1 and the interval contains a Monday, since 01/12/2022 is a Wednesday and 01/17/2022 is a Monday. +=WEEKS("01/10/2022","01/15/2022",1) returns 0 because Type was set to 1 and the interval does not contain any Mondays, except for the start date. + + +ORG.OPENOFFICE.WEEKS +
+
+WEEKSINYEAR function +number of weeks;in a specific year +mw added one entry + +

WEEKSINYEAR

+Calculates the number of weeks of the year in which the date entered occurs. The number of weeks is defined as follows: a week that spans two years is added to the year in which most days of that week occur. + +WEEKSINYEAR(Date) + +Date is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME. + +WEEKSINYEAR(A1) returns 53 if A1 contains 1970-02-17, a valid date for the year 1970. + + +ORG.OPENOFFICE.WEEKSINYEAR +
+ +

Add-ins through %PRODUCTNAME API

+Add-ins can also be implemented through the %PRODUCTNAME API. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060112.xhp b/helpcontent2/source/text/scalc/01/04060112.xhp new file mode 100644 index 000000000..5a80424b3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060112.xhp @@ -0,0 +1,682 @@ + + + + + +Add-in for Programming in $[officename] Calc +/text/scalc/01/04060112.xhp + + +Sun Microsystems, Inc. + + + +programming; add-ins +shared libraries; programming +external DLL functions +functions; $[officename] Calc add-in DLL +add-ins; for programming +mw made "external..." a one level entry and deleted one "functions;..." entry +

Add-in for Programming in $[officename] Calc

+The method of extending Calc by Add-Ins that is described in the following is outdated. The interfaces are still valid and supported, to ensure compatibility with existing Add-Ins, but for programming new Add-Ins you should use the new API functions. +$[officename] Calc can be expanded by Add-Ins, which are external programming modules providing additional functions for working with spreadsheets. These are listed in the Function Wizard in the Add-In category. If you would like to program an Add-In yourself, you can learn here which functions must be exported by the shared library +external DLL so that the Add-In can be successfully attached. +$[officename] searches the Add-in folder defined in the configuration for a suitable shared library +DLL. To be recognized by $[officename], the shared library +DLL must have certain properties, as explained in the following. This information allows you to program your own Add-In for Function Wizard of $[officename] Calc. +
+

The Add-In Concept

+Each Add-In library provides several functions. Some functions are used for administrative purposes. You can choose almost any name for your own functions. However, they must also follow certain rules regarding parameter passing. The exact naming and calling conventions vary for different platforms. +
+

Functions of Shared Library +AddIn DLL

+At a minimum, the administrative functions GetFunctionCount and GetFunctionData must exist. Using these, the functions as well as parameter types and return values can be determined. As return values, the Double and String types are supported. As parameters, additionally the cell areas Double Array, String Array, and Cell Array are supported. +Parameters are passed using references. Therefore, a change of these values is basically possible. However, this is not supported in $[officename] Calc because it does not make sense within spreadsheets. +Libraries can be reloaded during runtime and their contents can be analyzed by the administrative functions. For each function, information is available about count and type of parameters, internal and external function names and an administrative number. +The functions are called synchronously and return their results immediately. Real time functions (asynchronous functions) are also possible; however, they are not explained in detail because of their complexity. +

General information about the interface

+The maximum number of parameters in an Add-In function attached to $[officename] Calc is 16: one return value and a maximum of 15 function input parameters. +The data types are defined as follows: + + + + +Data types + + + + +Definition + + + + + + CALLTYPE + + +Under Windows: FAR PASCAL (_far _pascal) +Other: default (operating system specific default) + + + + + USHORT + + +2 Byte unsigned Integer + + + + + DOUBLE + + +8 byte platform-dependent format + + + + + Paramtype + + +Platform-dependent like int +PTR_DOUBLE =0 pointer to a double +PTR_STRING =1 pointer to a zero-terminated string +PTR_DOUBLE_ARR =2 pointer to a double array +PTR_STRING_ARR =3 pointer to a string array +PTR_CELL_ARR =4 pointer to a cell array +NONE =5 + + +
+ +

Shared Library +DLL functions

+Following you will find a description of those functions, which are called at the Shared Library +external DLL. +For all Shared Library +DLL functions, the following applies: +void CALLTYPE fn(out, in1, in2, ...) +Output: Resulting value +Input: Any number of types (double&, char*, double*, char**, Cell area), where the Cell area is an array of types double array, string array, or cell array. +

GetFunctionCount()

+Returns the number of functions without the management functions of the reference parameter. Each function has a unique number between 0 and nCount-1. This number will be needed for the GetFunctionData and GetParameterDescription functions later. + +Syntax + +void CALLTYPE GetFunctionCount(USHORT& nCount) + +Parameter + +USHORT &nCount: +Output: Reference to a variable, which is supposed to contain the number of Add-In functions. For example: If the Add-In provides 5 functions for $[officename] Calc, then nCount=5. +

GetFunctionData()

+Determines all the important information about an Add-In function. + +Syntax + +void CALLTYPE GetFunctionData(USHORT& nNo, char* pFuncName, USHORT& nParamCount, Paramtype* peType, char* pInternalName) + +Parameter + +USHORT& nNo: +Input: Function number between 0 and nCount-1, inclusively. +char* pFuncName: +Output: Function name as seen by the programmer, as it is named in the Shared Library +DLL. This name does not determine the name used in the Function Wizard. +USHORT& nParamCount: +Output: Number of parameters in AddIn function. This number must be greater than 0, because there is always a result value; the maximum value is 16. +Paramtype* peType: +Output: Pointer to an array of exactly 16 variables of type Paramtype. The first nParamCount entries are filled with the suitable type of parameter. +char* pInternalName: +Output: Function name as seen by the user, as it appears in the Function Wizard. May contain umlauts. +The pFuncName and pInternalName parameters are char arrays, which are implemented with size 256 in $[officename] Calc. +

GetParameterDescription()

+Provides a brief description of the Add-In function and its parameters. As an option, this function can be used to show a function and parameter description in the Function Wizard. + +Syntax + +void CALLTYPE GetParameterDescription(USHORT& nNo, USHORT& nParam, char* pName, char* pDesc) + +Parameter + +USHORT& nNo: +Input: Number of the function in the library; between 0 and nCount-1. +USHORT& nParam: +Input: Indicates, for which parameter the description is provided; parameters start at 1. If nParam is 0, the description itself is supposed to be provided in pDesc; in this case, pName does not have any meaning. +char* pName: +Output: Takes up the parameter name or type, for example, the word "Number" or "String" or "Date", and so on. Implemented in $[officename] Calc as char[256]. +char* pDesc: +Output: Takes up the description of the parameter, for example, "Value, at which the universe is to be calculated." Implemented in $[officename] Calc as char[256]. +pName and pDesc are char arrays; implemented in $[officename] Calc with size 256. Please note that the space available in the Function Wizard is limited and that the 256 characters cannot be fully used. +

Cell areas

+The following tables contain information about which data structures must be provided by an external program module in order to pass cell areas. $[officename] Calc distinguishes between three different arrays, depending on the data type. +

Double Array

+As a parameter, a cell area with values of the Number/Double type can be passed. A double array in $[officename] Calc is defined as follows: + + + +Offset + + + Name + + + Description + + + + + 0 + + +Col1 + + +Column number in the upper-left corner of the cell area. Numbering starts at 0. + + + + + 2 + + +Row1 + + +Row number in the upper-left corner of the cell area; numbering starts at 0. + + + + + 4 + + +Tab1 + + +Table number in the upper-left corner of the cell area; numbering starts at 0. + + + + + 6 + + +Col2 + + +Column number in the lower-right corner of the cell area. Numbering starts at 0. + + + + + 8 + + +Row2 + + +Row number in the lower-right corner of the cell area; numbering starts at 0. + + + + + 10 + + +Tab2 + + +Table number in the lower-right corner of the cell area; numbering starts at 0. + + + + + 12 + + +Count + + +Number of the following elements. Empty cells are not counted or passed. + + + + + 14 + + +Col + + +Column number of the element. Numbering starts at 0. + + + + + 16 + + +Row + + +Row number of the element; numbering starts at 0. + + + + + 18 + + +Tab + + +Table number of the element; numbering starts at 0. + + + + + 20 + + +Error + + +Error number, where the value 0 is defined as "no error." If the element comes from a formula cell the error value is determined by the formula. + + + + + 22 + + +Value + + +8 byte IEEE variable of type double/floating point + + + + + 30 + + + ... + + +Next element + + +
+ +

String Array

+A cell area, which contains values of data type Text and is passed as a string array. A string array in $[officename] Calc is defined as follows: + + + +Offset + + + Name + + + Description + + + + + 0 + + +Col1 + + +Column number in the upper-left corner of the cell area. Numbering starts at 0. + + + + + 2 + + +Row1 + + +Row number in the upper-left corner of the cell area; numbering starts at 0. + + + + + 4 + + + Tab1 + + +Table number in the upper-left corner of the cell area; numbering starts at 0. + + + + + 6 + + +Col2 + + +Column number in the lower-right corner of the cell area. Numbering starts at 0. + + + + + 8 + + +Row2 + + +Row number in the lower-right corner of the cell area; numbering starts at 0. + + + + + 10 + + +Tab2 + + +Table number in the lower-right corner of the cell area; numbering starts at 0. + + + + + 12 + + +Count + + +Number of the following elements. Empty cells are not counted or passed. + + + + + 14 + + +Col + + +Column number of the element. Numbering starts at 0. + + + + + 16 + + +Row + + +Row number of the element; numbering starts at 0. + + + + + 18 + + +Tab + + +Table number of the element; numbering starts at 0. + + + + + 20 + + +Error + + +Error number, where the value 0 is defined as "no error." If the element comes from a formula cell the error value is determined by the formula. + + + + + 22 + + +Len + + +Length of the following string, including closing zero byte. If the length including closing zero byte equals an odd value a second zero byte is added to the string so that an even value is achieved. Therefore, Len is calculated using ((StrLen+2)&~1). + + + + + 24 + + +String + + +String with closing zero byte + + + + + 24+Len + + + ... + + +Next element + + +
+ +

Cell Array

+Cell arrays are used to call cell areas containing text as well as numbers. A cell array in $[officename] Calc is defined as follows: + + + +Offset + + +Name + + +Description + + + + + 0 + + +Col1 + + +Column number in the upper-left corner of the cell area. Numbering starts at 0. + + + + + 2 + + +Row1 + + +Row number in the upper-left corner of the cell area; numbering starts at 0. + + + + + 4 + + +Tab1 + + +Table number in the upper-left corner of the cell area; numbering starts at 0. + + + + + 6 + + +Col2 + + +Column number in the lower-right corner of the cell area. Numbering starts at 0. + + + + + 8 + + +Row2 + + +Row number in the lower-right corner of the cell area; numbering starts at 0. + + + + + 10 + + +Tab2 + + +Table number in the lower-right corner of the cell area; numbering starts at 0. + + + + + 12 + + +Count + + +Number of the following elements. Empty cells are not counted or passed. + + + + + 14 + + +Col + + +Column number of the element. Numbering starts at 0. + + + + + 16 + + +Row + + +Row number of the element; numbering starts at 0. + + + + + 18 + + +Tab + + +Table number of the element; numbering starts at 0. + + + + + 20 + + +Error + + +Error number, where the value 0 is defined as "no error." If the element comes from a formula cell the error value is determined by the formula. + + + + + 22 + + +Type + + +Type of cell content, 0 == Double, 1 == String + + + + + 24 + + +Value or Len + + +If type == 0: 8 byte IEEE variable of type double/floating point +If type == 1: Length of the following string, including closing zero byte. If the length including closing zero byte equals an odd value a second zero byte is added to the string so that an even value is achieved. Therefore, Len is calculated using ((StrLen+2)&~1). + + + + +26 if type==1 + + +String + + +If type == 1: String with closing zero byte + + + + +32 or 26+Len + + +... + + +Next element + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060115.xhp b/helpcontent2/source/text/scalc/01/04060115.xhp new file mode 100644 index 000000000..f62e4d2a2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060115.xhp @@ -0,0 +1,428 @@ + + + + + + + Add-in Functions, List of Analysis Functions Part One + /text/scalc/01/04060115.xhp + + + + + + + add-ins; analysis functions + analysis functions + + +

Add-in Functions, List of Analysis Functions Part One

+The Add-in functions are supplied by the UNO com.sun.star.sheet.addin.Analysis service. +
+ +
+ + +
+ + Bessel functions + BESSELI function + + + + +

BESSELI

+Calculates the modified Bessel function of the first kind In(x). + + +BESSELI(X; N) + X is the value on which the function will be calculated. + N is a positive integer (N >= 0) representing the order of the Bessel function In(x) + + +=BESSELI(3.45, 4), returns 0.651416873060081 +=BESSELI(3.45, 4.333), returns 0.651416873060081, same as above because the fractional part of N is ignored. +=BESSELI(-1, 3), returns -0.022168424924332 +
+ +
+ + BESSELJ function + + + +

BESSELJ

+Calculates the Bessel function of the first kind Jn(x) (cylinder function). + + +BESSELJ(X; N) + X is the value on which the function will be calculated. + N is a positive integer (N >= 0) representing the order of the Bessel function Jn(x) + + +=BESSELJ(3.45, 4), returns 0.196772639864984 +=BESSELJ(3.45, 4.333), returns 0.196772639864984, same as above because the fractional part of N is ignored. +=BESSELJ(-1, 3), returns -0.019563353982668 +
+ +
+ + BESSELK function + + + +

BESSELK

+Calculates the modified Bessel function of the second kind Kn(x). + + +BESSELK(X; N) + X is the strictly positive value (X > 0) on which the function will be calculated. + N is a positive integer (N >= 0) representing the order of the Bessel function Kn(x) + + +=BESSELK(3.45, 4), returns 0.144803466373734 +=BESSELK(3.45, 4.333), returns 0.144803466373734, same as above because the fractional part of N is ignored. +=BESSELK(0, 3), returns Err:502 – invalid argument (X=0) +
+ +
+ + BESSELY function + + + +

BESSELY

+Calculates the Bessel function of the second kind Yn(x). + + +BESSELY(X; N) + X is the strictly positive value (X > 0) on which the function will be calculated. + N is a positive integer (N >= 0) representing the order of the Bessel function Yn(x) + + +=BESSELY(3.45, 4), returns -0.679848116844476 +=BESSELY(3.45, 4.333), returns -0.679848116844476, same as above because the fractional part of N is ignored. +=BESSELY(0, 3), returns Err:502 – invalid argument (X=0) +
+ +
+ + BIN2DEC function + converting;binary numbers, into decimal numbers + +mw added one entry + + +

BIN2DEC

+The result is the number for the binary (base-2) number string entered. + + +BIN2DEC(Number) + Number is a string representing a binary (base-2) number. It can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement. + + +=BIN2DEC("1100100") returns 100. +
+ +
+ + BIN2HEX function + converting;binary numbers, into hexadecimal numbers + +mw added one entry + + +

BIN2HEX

+The result is the string representing the number in hexadecimal form for the binary (base-2) number string entered. + + +BIN2HEX(Number [; Places]) +Number is a string representing a binary (base-2) number. It can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement. +Places means the number of places to be output. + + +=BIN2HEX("1100100";6) returns "000064". +
+ +
+ + BIN2OCT function + converting;binary numbers, into octal numbers + +mw added one entry + + +

BIN2OCT

+The result is the string representing the number in octal form for the binary (base-2) number string entered. + + +BIN2OCT(Number [; Places]) +Number is a string representing a binary (base-2) number. It can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement. +Places means the number of places to be output. + + +=BIN2OCT("1100100";4) returns "0144". +
+ +
+ + DELTA function + recognizing;equal numbers + +mw added one entry + + +

DELTA

+The result is TRUE (1) if both numbers, which are delivered as an argument, are equal, otherwise it is FALSE (0). + + +DELTA(Number1 [; Number2]) + + + =DELTA(1;2) returns 0. +
+ +
+ + DEC2BIN function + converting;decimal numbers, into binary numbers + +mw added one entry + + +

DEC2BIN

+The result is the string representing the number in binary (base-2) form for the number entered. + + +DEC2BIN(Number [; Places]) +Number is a number between -512 and 511. If Number is negative, the function returns a binary number string with 10 characters. The most significant bit is the sign bit, the other 9 bits return the value. +Places means the number of places to be output. + + +=DEC2BIN(100;8) returns "01100100". +
+ +
+ + DEC2HEX function + converting;decimal numbers, into hexadecimal numbers + +mw added one entr + + +

DEC2HEX

+The result is the string representing the number in hexadecimal form for the number entered. + + +DEC2HEX(Number [; Places]) +Number is a number. If Number is negative, the function returns a hexadecimal number string with 10 characters (40 bits). The most significant bit is the sign bit, the other 39 bits return the value. +Places means the number of places to be output. + + +=DEC2HEX(100;4) returns "0064". +
+ +
+ + DEC2OCT function + converting;decimal numbers, into octal numbers + +mw added one entr + + +

DEC2OCT

+The result is the string representing the number in octal form for the number entered. + + +DEC2OCT(Number [; Places]) +Number is a number. If Number is negative, the function returns an octal number string with 10 characters (30 bits). The most significant bit is the sign bit, the other 29 bits return the value. +Places means the number of places to be output. + + +=DEC2OCT(100;4) returns "0144". +
+ +
+ + ERF function + Gaussian error integral + +mw added one entr + + +

ERF

+Returns values of the Gaussian error integral. + + +ERF(LowerLimit [; UpperLimit]) + LowerLimit is the lower limit of the integral. + UpperLimit is optional. It is the upper limit of the integral. If this value is missing, the calculation takes place between 0 and the lower limit. + + + =ERF(0;1) returns 0.842701. +
+ +
+ + ERF.PRECISE function + Gaussian error integral + + + + +

ERF.PRECISE

+Returns values of the Gaussian error integral between 0 and the given limit. + +ERF.PRECISE(LowerLimit) +LowerLimit is the limit of the integral. The calculation takes place between 0 and this limit. + + + =ERF.PRECISE(1) returns 0.842701. + + + +COM.MICROSOFT.ERF.PRECISE +
+ +
+ + ERFC function + + + + +

ERFC

+Returns complementary values of the Gaussian error integral between x and infinity. + + +ERFC(LowerLimit) + LowerLimit is the lower limit of the integral + + + =ERFC(1) returns 0.157299. +
+ +
+ + ERFC.PRECISE function + + + + +

ERFC.PRECISE

+Returns complementary values of the Gaussian error integral between x and infinity. + +ERFC.PRECISE(LowerLimit) + LowerLimit is the lower limit of the integral + + + =ERFC.PRECISE(1) returns 0.157299. + + + +COM.MICROSOFT.ERFC.PRECISE +
+ +
+ + GESTEP function + numbers;greater than or equal to + +mw added one entry + + +

GESTEP

+The result is 1 if Number is greater than or equal to Step. + + +GESTEP(Number [; Step]) + + + =GESTEP(5;1) returns 1. +
+ +
+ + HEX2BIN function + converting;hexadecimal numbers, into binary numbers + +mw added one entry + + +

HEX2BIN

+The result is the string representing the number in binary (base-2) form for the hexadecimal number string entered. + + +HEX2BIN(Number [; Places]) +Number is a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement. +Places is the number of places to be output. + + +=HEX2BIN("6a";8) returns "01101010". +
+ +
+ + HEX2DEC function + converting;hexadecimal numbers, into decimal numbers + +mw added one entry + + +

HEX2DEC

+The result is the number for the hexadecimal number string entered. + + +HEX2DEC(Number) +Number is a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement. + + +=HEX2DEC("6a") returns 106. +
+ +
+ + HEX2OCT function + converting;hexadecimal numbers, into octal numbers + +mw added one entry + + +

HEX2OCT

+The result is the string representing the number in octal form for the hexadecimal number string entered. + + +HEX2OCT(Number [; Places]) +Number is a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement. +Places is the number of places to be output. + + +=HEX2OCT("6a";4) returns "0152". +
+ + +
+ + + + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/04060116.xhp b/helpcontent2/source/text/scalc/01/04060116.xhp new file mode 100644 index 000000000..ad42560a0 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060116.xhp @@ -0,0 +1,428 @@ + + + + + + + + + Add-in Functions, List of Analysis Functions Part Two + /text/scalc/01/04060116.xhp + + + +imaginary numbers in analysis functions + complex numbers in analysis functions + +

Add-in Functions, List of Analysis Functions Part Two

+The Add-in functions are supplied by the UNO com.sun.star.sheet.addin.Analysis service. +
+ +
+ +
+ +IMABS function + + +

IMABS

+ The result is the absolute value of a complex number. + + IMABS("ComplexNumber") + ComplexNumber is a complex number that is entered in the form "x+yi" or "x+yj". +no blanks allowed, see i82522 + + + =IMABS("5+12j") returns 13. +
+
+IMAGINARY function + + +

IMAGINARY

+ The result is the imaginary coefficient of a complex number. + + IMAGINARY("ComplexNumber") + + + + =IMAGINARY("4+3j") returns 3. +
+
+IMPOWER function + + +

IMPOWER

+ The result is the ComplexNumber raised to the power of Number. + + IMPOWER("ComplexNumber"; Number) + + + Number is the exponent. + + + =IMPOWER("2+3i";2) returns -5+12i. +
+
+IMARGUMENT function + + +

IMARGUMENT

+ The result is the argument (the phi angle) of a complex number. + + IMARGUMENT("ComplexNumber") + + + + =IMARGUMENT("3+4j") returns 0.927295. +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+IMDIV function + + +

IMDIV

+ The result is the division of two complex numbers. + + IMDIV("Numerator"; "Denominator") + + Numerator, Denominator are complex numbers that are entered in the form "x+yi" or "x+yj". + + + =IMDIV("-238+240i";"10+24i") returns 5+12i. +
+
+IMEXP function + + +

IMEXP

+ The result is the power of e and the complex number. The constant e has a value of approximately 2.71828182845904. + + IMEXP("ComplexNumber") + + + + =IMEXP("1+j") returns 1.47+2.29j (rounded). +
+
+IMCONJUGATE function + + +

IMCONJUGATE

+ The result is the conjugated complex complement to a complex number. + + IMCONJUGATE("ComplexNumber") + + + + =IMCONJUGATE("1+j") returns 1-j. +
+
+IMLN function + + +

IMLN

+ The result is the natural logarithm (to the base e) of a complex number. The constant e has a value of approximately 2.71828182845904. + + IMLN("ComplexNumber") + + + + =IMLN("1+j") returns 0.35+0.79j (rounded). +
+
+IMLOG10 function + + +

IMLOG10

+ The result is the common logarithm (to the base 10) of a complex number. + + IMLOG10("ComplexNumber") + + + + =IMLOG10("1+j") returns 0.15+0.34j (rounded). +
+
+IMLOG2 function + + +

IMLOG2

+ The result is the binary logarithm of a complex number. + + IMLOG2("ComplexNumber") + + + + =IMLOG2("1+j") returns 0.50+1.13j (rounded). +
+
+IMPRODUCT function + + +

IMPRODUCT

+ The result is the product of a set of complex numbers. + + IMPRODUCT() + + + + =IMPRODUCT("3+4j";"5-3j") returns 27+11j. +
+
+IMREAL function + + +

IMREAL

+ The result is the real coefficient of a complex number. + + IMREAL("ComplexNumber") + + + + =IMREAL("1+3j") returns 1. +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+

+ +

+ + + +
+
+IMSUB function + + +

IMSUB

+ The result is the subtraction of two complex numbers. + + IMSUB("ComplexNumber1"; "ComplexNumber2") + + + + =IMSUB("13+4j";"5+3j") returns 8+j. +
+
+IMSUM function + + +

IMSUM

+ The result is the sum of a set of complex numbers. + + IMSUM() + + + + =IMSUM("13+4j";"5+3j") returns 18+7j. +
+
+IMSQRT function + + +

IMSQRT

+ The result is the square root of a complex number. + + IMSQRT("ComplexNumber") + + + + =IMSQRT("3+4i") returns 2+1i. +
+
+COMPLEX function + + +

COMPLEX

+ The result is a complex number which is returned from a real coefficient and an imaginary coefficient. + + COMPLEX(RealNum; INum [; Suffix]) + + RealNum is the real coefficient of the complex number. + + INum is the imaginary coefficient of the complex number. + + Suffix is a list of options, "i" or "j". + + + =COMPLEX(3;4;"j") returns 3+4j. +
+
+OCT2BIN function + converting;octal numbers, into binary numbers +mw added one entry + +

OCT2BIN

+ The result is the string representing the number in binary (base-2) form for the octal number string entered. + + OCT2BIN(Number [; Places]) + + Number is a string that represents an octal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement. + + Places is the number of places to be output. + + + =OCT2BIN("3";3) returns "011". +
+
+OCT2DEC function + converting;octal numbers, into decimal numbers +mw added one entry + +

OCT2DEC

+ The result is the number for the octal number string entered. + + OCT2DEC(Number) + + Number is a string that represents an octal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement. + + + =OCT2DEC("144") returns 100. +
+
+OCT2HEX function + converting;octal numbers, into hexadecimal numbers +mw added one entry + +

OCT2HEX

+ The result is the string representing the number in hexadecimal form for the octal number string entered. + + OCT2HEX(Number [; Places]) + + Number is a string that represents an octal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement. + + Places is the number of places to be output. + + + =OCT2HEX("144";4) returns "0064". +
+ +
+

+ +

+ + + +
+ +
+FACTDOUBLE function + factorials;numbers with increments of two +mw added one entry + +

FACTDOUBLE

+ Returns the double factorial of a number. + + FACTDOUBLE(Number) + Returns Number + !!, the double factorial of Number, where Number is an integer greater than or equal to zero. + For even numbers FACTDOUBLE(n) returns: + 2*4*6*8* ... *n + For odd numbers FACTDOUBLE(n) returns: + 1*3*5*7* ... *n + FACTDOUBLE(0) returns 1 by definition. + + + =FACTDOUBLE(5) returns 15. + + =FACTDOUBLE(6) returns 48. + + =FACTDOUBLE(0) returns 1.see also FACT, MULTINOMIAL, PRODUCT +
+ +
+ + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060118.xhp b/helpcontent2/source/text/scalc/01/04060118.xhp new file mode 100644 index 000000000..f2f89d146 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060118.xhp @@ -0,0 +1,606 @@ + + + + + + + Financial Functions Part Three + /text/scalc/01/04060118.xhp + + + + + + +

Financial Functions Part Three

+ + + +
+ + ODDFPRICE function + prices;securities with irregular first interest date + +mw added one entry + + +

ODDFPRICE

+Calculates the price per 100 currency units par value of a security, if the first interest date falls irregularly. + + +ODDFPRICE(Settlement; Maturity; Issue; FirstCoupon; Rate; Yield; Redemption; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Issue is the date of issue of the security. +FirstCoupon is the first interest date of the security. +Rate is the annual rate of interest. +Yield is the annual yield of the security. +Redemption is the redemption value per 100 currency units of par value. +Frequency is number of interest payments per year (1, 2 or 4). + +
+ +
+ + ODDFYIELD function + + + + +

ODDFYIELD

+Calculates the yield of a security if the first interest date falls irregularly. + + +ODDFYIELD(Settlement; Maturity; Issue; FirstCoupon; Rate; Price; Redemption; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Issue is the date of issue of the security. +FirstCoupon is the first interest period of the security. +Rate is the annual rate of interest. +Price is the price of the security. +Redemption is the redemption value per 100 currency units of par value. +Frequency is number of interest payments per year (1, 2 or 4). + +
+ +
+ + ODDLPRICE function + + + + +

ODDLPRICE

+Calculates the price per 100 currency units par value of a security, if the last interest date falls irregularly. + + +ODDLPRICE(Settlement; Maturity; LastInterest; Rate; Yield; Redemption; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +LastInterest is the last interest date of the security. +Rate is the annual rate of interest. +Yield is the annual yield of the security. +Redemption is the redemption value per 100 currency units of par value. +Frequency is number of interest payments per year (1, 2 or 4). + + + +Settlement date: February 7 1999, maturity date: June 15 1999, last interest: October 15 1998. Interest rate: 3.75 per cent, yield: 4.05 per cent, redemption value: 100 currency units, frequency of payments: half-yearly = 2, basis: = 0 +The price per 100 currency units per value of a security, which has an irregular last interest date, is calculated as follows: +=ODDLPRICE("1999-02-07";"1999-06-15";"1998-10-15"; 0.0375; 0.0405;100;2;0) returns 99.87829. +
+ +
+ + ODDLYIELD function + + + + +

ODDLYIELD

+Calculates the yield of a security if the last interest date falls irregularly. + + +ODDLYIELD(Settlement; Maturity; LastInterest; Rate; Price; Redemption; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +LastInterest is the last interest date of the security. +Rate is the annual rate of interest. +Price is the price of the security. +Redemption is the redemption value per 100 currency units of par value. +Frequency is number of interest payments per year (1, 2 or 4). + + + +Settlement date: April 20 1999, maturity date: June 15 1999, last interest: October 15 1998. Interest rate: 3.75 per cent, price: 99.875 currency units, redemption value: 100 currency units, frequency of payments: half-yearly = 2, basis: = 0 +The yield of the security, that has an irregular last interest date, is calculated as follows: +=ODDLYIELD("1999-04-20";"1999-06-15"; "1998-10-15"; 0.0375; 99.875; 100;2;0) returns 0.044873 or 4.4873%. +
+ +
+ + calculating;variable declining depreciations + depreciations;variable declining + VDB function + + + + +

VDB

+Returns the depreciation of an asset for a specified or partial period using a variable declining balance method. + + +VDB(Cost; Salvage; Life; Start; End [; Factor [; NoSwitch]]) +Cost is the initial value of an asset. +Salvage is the value of an asset at the end of the depreciation. +Life is the depreciation duration of the asset. +S is the start of the depreciation. A must be entered in the same date unit as the duration. +End is the end of the depreciation. +Factor (optional) is the depreciation factor. Factor = 2 is double rate depreciation. +NoSwitchis an optional parameter. NoSwitch = 0 (default) means a switch to linear depreciation. In NoSwitch = 1 no switch is made. + + + +What is the declining-balance double-rate depreciation for a period if the initial cost is 35,000 currency units and the value at the end of the depreciation is 7,500 currency units. The depreciation period is 3 years. The depreciation from the 10th to the 20th period is calculated. +=VDB(35000;7500;36;10;20;2) = 8603.80 currency units. The depreciation during the period between the 10th and the 20th period is 8,603.80 currency units. +
+ +
+ + calculating;internal rates of return, irregular payments + internal rates of return;irregular payments + XIRR function + +mw changed "calculating;..." and "internal rates of return" + + +

XIRR

+Calculates the internal rate of return for a list of payments which take place on different dates. The calculation is based on a 365 days per year basis, ignoring leap years. +If the payments take place at regular intervals, use the IRR function. + + +XIRR(Values; Dates [; Guess]) +Values and Dates refer to a series of payments and the series of associated date values. The first pair of dates defines the start of the payment plan. All other date values must be later, but need not be in any order. The series of values must contain at least one negative and one positive value (receipts and deposits). +Guess (optional) is a guess that can be input for the internal rate of return. The default is 10%. + + +Calculation of the internal rate of return for the following five payments (dates are in ISO 8601 format): + + + + + + + A + + + B + + + C + + + + + 1 + + + 2001-01-01 + + + -10000 + + + Received + + + + + 2 + + + 2001-02-01 + + + 2000 + + + Deposited + + + + + 3 + + + 2001-03-15 + + + 2500 + + + + + + + 4 + + + 2001-05-12 + + + 5000 + + + + + + + 5 + + + 2001-08-10 + + + 1000 + + + + +
+ +=XIRR(B1:B5; A1:A5; 0.1) returns 0.1828 or 18.28%. +
+ +
+ + XNPV function + + + + +

XNPV

+Calculates the capital value (net present value) for a list of payments which take place on different dates. The calculation is based on a 365 days per year basis, ignoring leap years. +If the payments take place at regular intervals, use the NPV function. + + +XNPV(Rate; Values; Dates) +Rate is the internal rate of return for the payments. +Values and Dates refer to a series of payments and the series of associated date values. The first pair of dates defines the start of the payment plan. All other date values must be later, but need not be in any order. The series of values must contain at least one negative and one positive value (receipts and deposits) + + +Calculation of the net present value for the above-mentioned five payments for a national internal rate of return of 6%. +=XNPV(0.06;B1:B5;A1:A5) returns 323.02. +
+ +
+ + calculating;rates of return + RRI function + + + + +

RRI

+Calculates the interest rate resulting from the profit (return) of an investment. + + +RRI(P; PV; FV) +P is the number of periods needed for calculating the interest rate. +PV is the present (current) value. The cash value is the deposit of cash or the current cash value of an allowance in kind. As a deposit value a positive value must be entered; the deposit must not be 0 or <0. +FV determines what is desired as the cash value of the deposit. + + +For four periods (years) and a cash value of 7,500 currency units, the interest rate of the return is to be calculated if the future value is 10,000 currency units. +=RRI(4;7500;10000) = 7.46 % +The interest rate must be 7.46 % so that 7,500 currency units will become 10,000 currency units. +
+ +
+ + calculating;constant interest rates + constant interest rates + RATE function + + + + +

RATE

+Returns the constant interest rate per period of an annuity. + + +RATE(NPer; Pmt; PV [ ; [ FV ] [ ; [ Type ] [ ; Guess ] ] ]) +NPer is the total number of periods, during which payments are made (payment period). +Pmt is the constant payment (annuity) paid during each period. +PV is the cash value in the sequence of payments. +FV (optional) is the future value, which is reached at the end of the periodic payments. +Type (optional) is the due date of the periodic payment, either at the beginning or at the end of a period. +Guess (optional) determines the estimated value of the interest with iterative calculation. + + + +What is the constant interest rate for a payment period of 3 periods if 10 currency units are paid regularly and the present cash value is 900 currency units. +=RATE(3;-10;900) = -75.63% The interest rate is therefore 75.63%. +
+ +
+ + INTRATE function + + + + +

INTRATE

+Calculates the annual interest rate that results when a security (or other item) is purchased at an investment value and sold at a redemption value. No interest is paid. + + +INTRATE(Settlement; Maturity; Investment; Redemption [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security is sold. +Investment is the purchase price. +Redemption is the selling price. + + + +A painting is bought on 1990-01-15 for 1 million and sold on 2002-05-05 for 2 million. The basis is daily balance calculation (basis = 3). What is the average annual level of interest? +=INTRATE("1990-01-15"; "2002-05-05"; 1000000; 2000000; 3) returns 8.12%. +
+ +
+ + COUPNCD function + + + + +

COUPNCD

+Returns the date of the first interest date after the settlement date. Format the result as a date. + + +COUPNCD(Settlement; Maturity; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Frequency is number of interest payments per year (1, 2 or 4). + + + +A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) when is the next interest date? +=COUPNCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2001-05-15. +
+ +
+ + COUPDAYS function + + + + +

COUPDAYS

+Returns the number of days in the current interest period in which the settlement date falls. + + +COUPDAYS(Settlement; Maturity; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Frequency is number of interest payments per year (1, 2 or 4). + + + +A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days are there in the interest period in which the settlement date falls? +=COUPDAYS("2001-01-25"; "2001-11-15"; 2; 3) returns 181. +
+ +
+ + COUPDAYSNC function + + + + +

COUPDAYSNC

+Returns the number of days from the settlement date until the next interest date. + + +COUPDAYSNC(Settlement; Maturity; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Frequency is number of interest payments per year (1, 2 or 4). + + + +A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days are there until the next interest payment? +=COUPDAYSNC("2001-01-25"; "2001-11-15"; 2; 3) returns 110. +
+ +
+ + COUPDAYBS function + durations;first interest payment until settlement date + securities;first interest payment until settlement date + +mw added "durations;" and "securities;" + + +

COUPDAYBS

+Returns the number of days from the first day of interest payment on a security until the settlement date. + + +COUPDAYBS(Settlement; Maturity; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Frequency is the number of interest payments per year (1, 2 or 4). + + + +A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days is this? +=COUPDAYBS("2001-01-25"; "2001-11-15"; 2; 3) returns 71. +
+ +
+ + COUPPCD function + dates;interest date prior to settlement date + +mw added "dates;" + + +

COUPPCD

+Returns the date of the interest date prior to the settlement date. Format the result as a date. + + +COUPPCD(Settlement; Maturity; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Frequency is the number of interest payments per year (1, 2 or 4). + + + +A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) what was the interest date prior to purchase? +=COUPPCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2000-15-11. +
+ +
+ + COUPNUM function + number of coupons + +mw added "number..." + + +

COUPNUM

+Returns the number of coupons (interest payments) between the settlement date and the maturity date. + + +COUPNUM(Settlement; Maturity; Frequency [; Basis]) +Settlement is the date of purchase of the security. +Maturity is the date on which the security matures (expires). +Frequency is the number of interest payments per year (1, 2 or 4). + + + +A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many interest dates are there? +=COUPNUM("2001-01-25"; "2001-11-15"; 2; 3) returns 2. +
+ +
+ + IPMT function + periodic amortizement rates + +mw added "periodic..." + + +

IPMT

+Calculates the periodic amortizement for an investment with regular payments and a constant interest rate. + + +IPMT(Rate; Period; NPer; PV [; FV [; Type]]) +Rate is the periodic interest rate. +Period is the period, for which the compound interest is calculated. Period=NPER if compound interest for the last period is calculated. +NPer is the total number of periods, during which annuity is paid. +PV is the present cash value in sequence of payments. +FV (optional) is the desired value (future value) at the end of the periods. +Type is the due date for the periodic payments. + + +What is the interest rate during the fifth period (year) if the constant interest rate is 5% and the cash value is 15,000 currency units? The periodic payment is seven years. +=IPMT(5%;5;7;15000) = -352.97 currency units. The compound interest during the fifth period (year) is 352.97 currency units. +
+ +
+ + calculating;future values + future values;constant interest rates + FV function + +mw made "future values..." a two level entry + + +

FV

+Returns the future value of an investment based on periodic, constant payments and a constant interest rate (Future Value). + + +FV(Rate; NPer; Pmt [ ; [ PV ] [ ; Type ] ]) +Rate is the periodic interest rate. +NPer is the total number of periods (payment period). +Pmt is the annuity paid regularly per period. +PV (optional) is the (present) cash value of an investment. +Type (optional) defines whether the payment is due at the beginning or the end of a period. + + + +What is the value at the end of an investment if the interest rate is 4% and the payment period is two years, with a periodic payment of 750 currency units. The investment has a present value of 2,500 currency units. +=FV(4%;2;750;2500) = -4234.00 currency units. The value at the end of the investment is 4234.00 currency units. +
+ +
+ + FVSCHEDULE function + future values;varying interest rates + +mw added "future values" + + +

FVSCHEDULE

+Calculates the accumulated value of the starting capital for a series of periodically varying interest rates. + + +FVSCHEDULE(Principal; Schedule) +Principal is the starting capital. +Schedule is a series of interest rates, for example, as a range H3:H5 or as a (List) (see example). + + + +1000 currency units have been invested in for three years. The interest rates were 3%, 4% and 5% per annum. What is the value after three years? +=FVSCHEDULE(1000;{0.03;0.04;0.05}) returns 1124.76. +
+ +
+ + calculating;number of payment periods + payment periods;number of + number of payment periods + NPER function + + + + +

NPER

+Returns the number of periods for an investment based on periodic, constant payments and a constant interest rate. + + +NPER(Rate; Pmt; PV [ ; [ FV ] [ ; Type ] ]) +Rate is the periodic interest rate. +Pmt is the constant annuity paid in each period. +PV is the present value (cash value) in a sequence of payments. +FV (optional) is the future value, which is reached at the end of the last period. +Type (optional) is the due date of the payment at the beginning or at the end of the period. + + + +How many payment periods does a payment period cover with a periodic interest rate of 6%, a periodic payment of 153.75 currency units and a present cash value of 2.600 currency units. +=NPER(6%;153.75;2600) = -12,02. The payment period covers 12.02 periods. +
+ +Back to Financial Functions Part One +Back to Financial Functions Part Two + + + + diff --git a/helpcontent2/source/text/scalc/01/04060119.xhp b/helpcontent2/source/text/scalc/01/04060119.xhp new file mode 100644 index 000000000..ccf3e35ad --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060119.xhp @@ -0,0 +1,611 @@ + + + + + + + + +Financial Functions Part Two +/text/scalc/01/04060119.xhp + + + +

Financial Functions Part Two

+
+ +
+Back to Financial Functions Part One +Forward to Financial Functions Part Three + +
+PPMT function + + +

PPMT

+Returns for a given period the payment on the principal for an investment that is based on periodic and constant payments and a constant interest rate. + +PPMT(Rate; Period; NPer; PV [ ; FV [ ; Type ] ]) + +Rate is the periodic interest rate. + +Period is the amortizement period. P = 1 for the first and P = NPer for the last period. + +NPer is the total number of periods during which annuity is paid. + +PV is the present value in the sequence of payments. + +FV (optional) is the desired (future) value. + +Type (optional) defines the due date. F = 1 for payment at the beginning of a period and F = 0 for payment at the end of a period. + + + + +How high is the periodic monthly payment at an annual interest rate of 8.75% over a period of 3 years? The cash value is 5,000 currency units and is always paid at the beginning of a period. The future value is 8,000 currency units. + +=PPMT(8.75%/12;1;36;5000;8000;1) = -350.99 currency units. +
+
+calculating; total amortizement rates +total amortizement rates +amortization installment +repayment installment +CUMPRINC function +mw added two entries + +

CUMPRINC

+Returns the cumulative interest paid for an investment period with a constant interest rate. + +CUMPRINC(Rate; NPer; PV; S; E; Type) + +Rate is the periodic interest rate. + +NPer is the payment period with the total number of periods. NPER can also be a non-integer value. + +PV is the current value in the sequence of payments. + +S is the first period. + +E is the last period. + +Type is the due date of the payment at the beginning or end of each period. + +What are the payoff amounts if the yearly interest rate is 5.5% for 36 months? The cash value is 15,000 currency units. The payoff amount is calculated between the 10th and 18th period. The due date is at the end of the period. + +=CUMPRINC(5.5%/12;36;15000;10;18;0) = -3669.74 currency units. The payoff amount between the 10th and 18th period is 3669.74 currency units. +
+
+CUMPRINC_ADD function + + +

CUMPRINC_ADD

+ Calculates the cumulative redemption of a loan in a period. + + +CUMPRINC_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type) + +Rate is the interest rate for each period. + +NPer is the total number of payment periods. The rate and NPER must refer to the same unit, and thus both be calculated annually or monthly. + +PV is the current value. + +StartPeriod is the first payment period for the calculation. + +EndPeriod is the last payment period for the calculation. + +Type is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1). + +The following mortgage loan is taken out on a house: +Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (payment periods = 30 * 12 = 360), NPV: 125000 currency units. +How much will you repay in the second year of the mortgage (thus from periods 13 to 24)? + +=CUMPRINC_ADD(0.0075;360;125000;13;24;0) returns -934.1071 +In the first month you will be repaying the following amount: + +=CUMPRINC_ADD(0.0075;360;125000;1;1;0) returns -68.27827 +
+
+calculating; accumulated interests +accumulated interests +CUMIPMT function + + +

CUMIPMT

+Calculates the cumulative interest payments, that is, the total interest, for an investment based on a constant interest rate. + +CUMIPMT(Rate; NPer; PV; S; E; Type) + +Rate is the periodic interest rate. + +NPer is the payment period with the total number of periods. NPER can also be a non-integer value. + +PV is the current value in the sequence of payments. + +S is the first period. + +E is the last period. + +Type is the due date of the payment at the beginning or end of each period. + +What are the interest payments at a yearly interest rate of 5.5 %, a payment period of monthly payments for 2 years and a current cash value of 5,000 currency units? The start period is the 4th and the end period is the 6th period. The payment is due at the beginning of each period. + +=CUMIPMT(5.5%/12;24;5000;4;6;1) = -57.54 currency units. The interest payments for between the 4th and 6th period are 57.54 currency units. +
+
+CUMIPMT_ADD function + + +

CUMIPMT_ADD

+Calculates the accumulated interest for a period. + + +CUMIPMT_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type) + +Rate is the interest rate for each period. + +NPer is the total number of payment periods. The rate and NPER must refer to the same unit, and thus both be calculated annually or monthly. + +PV is the current value. + +StartPeriod is the first payment period for the calculation. + +EndPeriod is the last payment period for the calculation. + +Type is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1). + +The following mortgage loan is taken out on a house: +Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (NPER = 30 * 12 = 360), Pv: 125000 currency units. +How much interest must you pay in the second year of the mortgage (thus from periods 13 to 24)? + +=CUMIPMT_ADD(0.0075;360;125000;13;24;0) returns -11135.23. +How much interest must you pay in the first month? + +=CUMIPMT_ADD(0.0075;360;125000;1;1;0) returns -937.50. +
+
+PRICE function +prices; fixed interest securities +sales values;fixed interest securities +mw added two entries + +

PRICE

+Calculates the market value of a fixed interest security with a par value of 100 currency units as a function of the forecast yield. + +PRICE(Settlement; Maturity; Rate; Yield; Redemption; Frequency [; Basis]) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Rate is the annual nominal rate of interest (coupon interest rate) + +Yield is the annual yield of the security. + +Redemption is the redemption value per 100 currency units of par value. + +Frequency is the number of interest payments per year (1, 2 or 4). + + +A security is purchased on 1999-02-15; the maturity date is 2007-11-15. The nominal rate of interest is 5.75%. The yield is 6.5%. The redemption value is 100 currency units. Interest is paid half-yearly (frequency is 2). With calculation on basis 0, the price is as follows: +=PRICE("1999-02-15"; "2007-11-15"; 0.0575; 0.065; 100; 2; 0) returns 95.04287. +
+
+PRICEDISC function +prices;non-interest-bearing securities +sales values;non-interest-bearing securities +mw added two entries + +

PRICEDISC

+Calculates the price per 100 currency units of par value of a non-interest- bearing security. + +PRICEDISC(Settlement; Maturity; Discount; Redemption [; Basis]) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Discount is the discount of a security as a percentage. + +Redemption is the redemption value per 100 currency units of par value. + + +A security is purchased on 1999-02-15; the maturity date is 1999-03-01. Discount in per cent is 5.25%. The redemption value is 100. When calculating on basis 2 the price discount is as follows: +=PRICEDISC("1999-02-15"; "1999-03-01"; 0.0525; 100; 2) returns 99.79583. +
+
+PRICEMAT function +prices;interest-bearing securities +mw added one entry + +

PRICEMAT

+Calculates the price per 100 currency units of par value of a security, that pays interest on the maturity date. + +PRICEMAT(Settlement; Maturity; Issue; Rate; Yield [; Basis]) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Issue is the date of issue of the security. + +Rate is the interest rate of the security on the issue date. + +Yield is the annual yield of the security. + + +Settlement date: February 15 1999, maturity date: April 13 1999, issue date: November 11 1998. Interest rate: 6.1 per cent, yield: 6.1 per cent, basis: 30/360 = 0. +The price is calculated as follows: +=PRICEMAT("1999-02-15";"1999-04-13";"1998-11-11"; 0.061; 0.061;0) returns 99.98449888. +
+
+calculating; durations +durations;calculating +PDURATION function + + +

PDURATION

+Calculates the number of periods required by an investment to attain the desired value. + +PDURATION(Rate; PV; FV) + +Rate is a constant. The interest rate is to be calculated for the entire duration (duration period). The interest rate per period is calculated by dividing the interest rate by the calculated duration. The internal rate for an annuity is to be entered as Rate/12. + +PV is the present (current) value. The cash value is the deposit of cash or the current cash value of an allowance in kind. As a deposit value a positive value must be entered; the deposit must not be 0 or <0. + +FV is the expected value. The future value determines the desired (future) value of the deposit. + +At an interest rate of 4.75%, a cash value of 25,000 currency units and a future value of 1,000,000 currency units, a duration of 79.49 payment periods is returned. The periodic payment is the resulting quotient from the future value and the duration, in this case 1,000,000/79.49=12,850.20. +
+
+calculating;linear depreciations +depreciations;linear +linear depreciations +straight-line depreciations +SLN function +mw added one entry + +

SLN

+Returns the straight-line depreciation of an asset for one period. The amount of the depreciation is constant during the depreciation period. + +SLN(Cost; Salvage; Life) + +Cost is the initial cost of an asset. + +Salvage is the value of an asset at the end of the depreciation. + +Life is the depreciation period determining the number of periods in the depreciation of the asset. + +Office equipment with an initial cost of 50,000 currency units is to be depreciated over 7 years. The value at the end of the depreciation is to be 3,500 currency units. + +=SLN(50000;3,500;84) = 553.57 currency units. The periodic monthly depreciation of the office equipment is 553.57 currency units. +
+
+MDURATION function +Macauley duration +mw added one entry + +

MDURATION

+Calculates the modified Macauley duration of a fixed interest security in years. + +MDURATION(Settlement; Maturity; Coupon; Yield; Frequency [; Basis]) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Coupon is the annual nominal rate of interest (coupon interest rate) + +Yield is the annual yield of the security. + +Frequency is the number of interest payments per year (1, 2 or 4). + + +A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The nominal rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how long is the modified duration? +=MDURATION("2001-01-01"; "2006-01-01"; 0.08; 0.09; 2; 3) returns 4.02 years. +
+
+calculating;net present values +net present values +NPV function + + +

NPV

+Returns the present value of an investment based on a series of periodic cash flows and a discount rate. To get the net present value, subtract the cost of the project (the initial cash flow at time zero) from the returned value. +If the payments take place at irregular intervals, use the XNPV function. + + + +NPV(Rate; ) +Rate is the discount rate for a period. + + + + +What is the net present value of periodic payments of 10, 20 and 30 currency units with a discount rate of 8.75%. At time zero the costs were paid as -40 currency units. + +=NPV(8.75%;10;20;30) = 49.43 currency units. The net present value is the returned value minus the initial costs of 40 currency units, therefore 9.43 currency units. +
+
+calculating;nominal interest rates +nominal interest rates +NOMINAL function +mw made "nominal interest rates;..." a one level entry + +

NOMINAL

+Calculates the yearly nominal interest rate, given the effective rate and the number of compounding periods per year. + +NOMINAL(EffectiveRate; NPerY) + +EffectiveRate is the effective interest rate + +NPerY is the number of periodic interest payments per year. + +What is the nominal interest per year for an effective interest rate of 13.5% if twelve payments are made per year. + +=NOMINAL(13.5%;12) = 12.73%. The nominal interest rate per year is 12.73%. +
+
+NOMINAL_ADD function + + +

NOMINAL_ADD

+Calculates the annual nominal rate of interest on the basis of the effective rate and the number of interest payments per annum. + + +NOMINAL_ADD(EffectiveRate; NPerY) + +EffectiveRate is the effective annual rate of interest. + +NPerY the number of interest payments per year. + +What is the nominal rate of interest for a 5.3543% effective rate of interest and quarterly payment. + +=NOMINAL_ADD(5.3543%;4) returns 0.0525 or 5.25%. +
+
+DOLLARFR function +converting;decimal fractions, into mixed decimal fractions +mw added one entry + +

DOLLARFR

+Converts a quotation that has been given as a decimal number into a mixed decimal fraction. + +DOLLARFR(DecimalDollar; Fraction) + +DecimalDollar is a decimal number. + +Fraction is a whole number that is used as the denominator of the decimal fraction. + + +=DOLLARFR(1.125;16) converts into sixteenths. The result is 1.02 for 1 plus 2/16. + +=DOLLARFR(1.125;8) converts into eighths. The result is 1.1 for 1 plus 1/8. +
+
+fractions; converting +converting;decimal fractions, into decimal numbers +DOLLARDE function +mw added one entry + +

DOLLARDE

+Converts a quotation that has been given as a decimal fraction into a decimal number. + +DOLLARDE(FractionalDollar; Fraction) + +FractionalDollar is a number given as a decimal fraction. + +Fraction is a whole number that is used as the denominator of the decimal fraction. + + +=DOLLARDE(1.02;16) stands for 1 and 2/16. This returns 1.125. + +=DOLLARDE(1.1;8) stands for 1 and 1/8. This returns 1.125. +
+
+calculating;modified internal rates of return +modified internal rates of return +MIRR function +internal rates of return;modified +mw added "internal rates of return;..." + +

MIRR

+Calculates the modified internal rate of return of a series of investments. + +MIRR(Values; Investment; ReinvestRate) + +Values corresponds to the array or the cell reference for cells whose content corresponds to the payments. + +Investment is the rate of interest of the investments (the negative values of the array) + +ReinvestRate:the rate of interest of the reinvestment (the positive values of the array) + +Assuming a cell content of A1 = -5, A2 = 10, A3 = 15, and A4 = 8, and an investment value of 0.5 and a reinvestment value of 0.1, the result is 94.16%. +
+
+YIELD function +rates of return;securities +yields, see also rates of return +mw added two entries + +

YIELD

+Calculates the yield of a security. + +YIELD(Settlement; Maturity; Rate; Price; Redemption; Frequency [; Basis]) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Rate is the annual rate of interest. + +Price is the price (purchase price) of the security per 100 currency units of par value. + +Redemption is the redemption value per 100 currency units of par value. + +Frequency is the number of interest payments per year (1, 2 or 4). + + +A security is purchased on 1999-02-15. It matures on 2007-11-15. The rate of interest is 5.75%. The price is 95.04287 currency units per 100 units of par value, the redemption value is 100 units. Interest is paid half-yearly (frequency = 2) and the basis is 0. How high is the yield? +=YIELD("1999-02-15"; "2007-11-15"; 0.0575 ;95.04287; 100; 2; 0) returns 0.065 or 6.50 per cent. +
+
+YIELDDISC function +rates of return;non-interest-bearing securities +mw added one entry + +

YIELDDISC

+Calculates the annual yield of a non-interest-bearing security. + +YIELDDISC(Settlement; Maturity; Price; Redemption [; Basis]) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Price is the price (purchase price) of the security per 100 currency units of par value. + +Redemption is the redemption value per 100 currency units of par value. + + +A non-interest-bearing security is purchased on 1999-02-15. It matures on 1999-03-01. The price is 99.795 currency units per 100 units of par value, the redemption value is 100 units. The basis is 2. How high is the yield? +=YIELDDISC("1999-02-15"; "1999-03-01"; 99.795; 100; 2) returns 0.052823 or 5.2823 per cent. +
+
+YIELDMAT function +rates of return;securities with interest paid on maturity +mw added one entry + +

YIELDMAT

+Calculates the annual yield of a security, the interest of which is paid on the date of maturity. + +YIELDMAT(Settlement; Maturity; Issue; Rate; Price [; Basis]) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Issue is the date of issue of the security. + +Rate is the interest rate of the security on the issue date. + +Price is the price (purchase price) of the security per 100 currency units of par value. + + +A security is purchased on 1999-03-15. It matures on 1999-11-03. The issue date was 1998-11-08. The rate of interest is 6.25%, the price is 100.0123 units. The basis is 0. How high is the yield? +=YIELDMAT("1999-03-15"; "1999-11-03"; "1998-11-08"; 0.0625; 100.0123; 0) returns 0.060954 or 6.0954 per cent. +
+
+calculating;annuities +annuities +PMT function + + +

PMT

+Returns the periodic payment for an annuity with constant interest rates. + +PMT(Rate; NPer; PV [ ; [ FV ] [ ; Type ] ]) + +Rate is the periodic interest rate. + +NPer is the number of periods in which annuity is paid. + +PV is the present value (cash value) in a sequence of payments. + +FV (optional) is the desired value (future value) to be reached at the end of the periodic payments. + +Type (optional) is the due date for the periodic payments. Type=1 is payment at the beginning and Type=0 is payment at the end of each period. + + + + +What are the periodic payments at a yearly interest rate of 1.99% if the payment time is 3 years and the cash value is 25,000 currency units. There are 36 months as 36 payment periods, and the interest rate per payment period is 1.99%/12. + +=PMT(1.99%/12;36;25000) = -715.96 currency units. The periodic monthly payment is therefore 715.96 currency units. +
+
+TBILLEQ function +treasury bills;annual return +annual return on treasury bills +mw changed "treasury bills;..." and added one entry + +

TBILLEQ

+Calculates the annual return on a treasury bill. A treasury bill is purchased on the settlement date and sold at the full par value on the maturity date, that must fall within the same year. A discount is deducted from the purchase price. + +TBILLEQ(Settlement; Maturity; Discount) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Discount is the percentage discount on acquisition of the security. + +Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9.14 per cent. +The return on the treasury bill corresponding to a security is worked out as follows: +=TBILLEQ("1999-03-31";"1999-06-01"; 0.0914) returns 0.094151 or 9.4151 per cent. +
+
+TBILLPRICE function +treasury bills;prices +prices;treasury bills +mw added two entries + +

TBILLPRICE

+Calculates the price of a treasury bill per 100 currency units. + +TBILLPRICE(Settlement; Maturity; Discount) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Discount is the percentage discount upon acquisition of the security. + +Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9 per cent. +The price of the treasury bill is worked out as follows: +=TBILLPRICE("1999-03-31";"1999-06-01"; 0.09) returns 98.45. +
+
+TBILLYIELD function +treasury bills;rates of return +rates of return of treasury bills +mw added two entries + +

TBILLYIELD

+Calculates the yield of a treasury bill. + +TBILLYIELD(Settlement; Maturity; Price) + +Settlement is the date of purchase of the security. + +Maturity is the date on which the security matures (expires). + +Price is the price (purchase price) of the treasury bill per 100 currency units of par value. + +Settlement date: March 31 1999, maturity date: June 1 1999, price: 98.45 currency units. +The yield of the treasury bill is worked out as follows: +=TBILLYIELD("1999-03-31";"1999-06-01"; 98.45) returns 0.091417 or 9.1417 per cent. +
+ +Back to Financial Functions Part One +Forward to Financial Functions Part Three + + + diff --git a/helpcontent2/source/text/scalc/01/04060120.xhp b/helpcontent2/source/text/scalc/01/04060120.xhp new file mode 100644 index 000000000..b5e805053 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060120.xhp @@ -0,0 +1,129 @@ + + + + + + + + +Bit Operation Functions +/text/scalc/01/04060120.xhp + + + +

Bit Operation Functions

+
+ +
+ +
+BITAND function + + +

BITAND

+Returns a bitwise logical "and" of the parameters. + + +BITAND(number1; number2) + +Number1 and number2 are positive integers less than 2 ^ 48 (281 474 976 710 656). + + +=BITAND(6;10) returns 2 (0110 & 1010 = 0010). +
+
+BITOR function + + +

BITOR

+Returns a bitwise logical "or" of the parameters. + + +BITOR(number1; number2) + +Number1 and number2 are positive integers less than 2 ^ 48 (281 474 976 710 656). + +=BITOR(6;10) returns 14 (0110 | 1010 = 1110). +
+
+BITXOR function + + +

BITXOR

+Returns a bitwise logical "exclusive or" of the parameters. + + +BITXOR(number1; number2) + +Number1 and number2 are positive integers less than 2 ^ 48 (281 474 976 710 656). + + +=BITXOR(6;10) returns 12 (0110 ^ 1010 = 1100) +
+
+BITLSHIFT function + + +

BITLSHIFT

+Shifts a number left by n bits. + + +BITLSHIFT(number; shift) + +Number is a positive integer less than 2 ^ 48 (281 474 976 710 656). + +Shift is the number of positions the bits will be moved to the left. If shift is negative, it is synonymous with BITRSHIFT (number; -shift). + + +=BITLSHIFT(6;1) returns 12 (0110 << 1 = 1100). +
+
+BITRSHIFT function + + +

BITRSHIFT

+Shifts a number right by n bits. + + +BITRSHIFT(number; shift) + +Number is a positive integer less than 2 ^ 48 (281 474 976 710 656). + +Shift is the number of positions the bits will be moved to the right. If shift is negative, it is synonymous with BITLSHIFT (number; -shift). + + +=BITRSHIFT(6;1) returns 3 (0110 >> 1 = 0011). +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060181.xhp b/helpcontent2/source/text/scalc/01/04060181.xhp new file mode 100644 index 000000000..c2c24850d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060181.xhp @@ -0,0 +1,714 @@ + + + + + + + Statistical Functions Part One + /text/scalc/01/04060181.xhp + + + + +

Statistical Functions Part One

+ + +
+ + INTERCEPT function + points of intersection + intersections + +mw added two entries + + +

INTERCEPT

+Calculates the point at which a line will intersect the y-values by using known x-values and y-values. + + +INTERCEPT(DataY; DataX) +DataY is the dependent set of observations or data. +DataX is the independent set of observations or data. +Names, arrays or references containing numbers must be used here. Numbers can also be entered directly. + + +To calculate the intercept, use cells D3:D9 as the y value and C3:C9 as the x value from the example spreadsheet. Input will be as follows: +=INTERCEPT(D3:D9;C3:C9) = 2.15. +
+ +
+ + COUNT function + numbers;counting + +mw added one entry + + +

COUNT

+Counts how many numbers are in the list of arguments. Text entries are ignored. + + +COUNT() + + + +The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted. +=COUNT(2;4;6;"eight") = 3. The count of numbers is therefore 3. +
+ +
+ + COUNTA function + number of entries + +mw added one entry + + +

COUNTA

+Counts how many values are in the list of arguments. Text entries are also counted, even when they contain an empty string of length 0. If an argument is an array or reference, empty cells within the array or reference are ignored.UFI: fix to #i35888# + +COUNTA() + + +The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted. +=COUNTA(2;4;6;"eight") = 4. The count of values is therefore 4. +
+ +
+ + COUNTBLANK function + counting;empty cells + empty cells;counting + + + + +

COUNTBLANK

+Returns the number of empty cells. + + +COUNTBLANK(Range) +Returns the number of empty cells in the cell range Range. + + +=COUNTBLANK(A1:B2) returns 4 if cells A1, A2, B1, and B2 are all empty.see also COUNTIF +
+ +
+ + COUNTIF function + counting;specified cells + +mw added one entry + + +

COUNTIF

+Returns the number of cells that meet with certain criteria within a cell range. + +COUNTIF(Range; Criterion) +Range is the range to which the criteria are to be applied. + + + +A1:A10 is a cell range containing the numbers 2000 to 2009. Cell B1 contains the number 2006. In cell B2, you enter a formula: +=COUNTIF(A1:A10;2006) - this returns 1. +=COUNTIF(A1:A10;B1) - this returns 1. +=COUNTIF(A1:A10;">=2006") - this returns 4. +=COUNTIF(A1:A10;"<"&B1) - when B1 contains 2006, this returns 6. +=COUNTIF(A1:A10;C2) where cell C2 contains the text >2006 counts the number of cells in the range A1:A10 which are >2006. +To count only negative numbers: =COUNTIF(A1:A10;"<0") +
+ +
+ +

+ +
+ +
+ + B function + probabilities of samples with binomial distribution + +mw added one entry + + +

B

+Returns the probability of a sample with binomial distribution. + + +B(Trials; SP; T1 [; T2]) +Trials is the number of independent trials. +SP is the probability of success on each trial. +T1 defines the lower limit for the number of trials. +T2 (optional) defines the upper limit for the number of trials. + + +What is the probability with ten throws of the dice, that a six will come up exactly twice? The probability of a six (or any other number) is 1/6. The following formula combines these factors: +=B(10;1/6;2) returns a probability of 29%. +
+ +
+ + RSQ function + determination coefficients + regression analysis + +mw added regression analysis + + +

RSQ

+Returns the square of the Pearson correlation coefficient based on the given values. RSQ (also called determination coefficient) is a measure for the accuracy of an adjustment and can be used to produce a regression analysis. + + +RSQ(DataY; DataX) +DataY is an array or range of data points. +DataX is an array or range of data points. + + +=RSQ(A1:A20;B1:B20) calculates the determination coefficient for both data sets in columns A and B. +
+ +
+ + BETAINV function + cumulative probability density function;inverse of + +mw added one entry + + +

BETAINV

+Returns the inverse of the cumulative Beta probability density function. + + +BETAINV(Number; Alpha; Beta [; Start [; End]]) +Number is the probability associated with the Beta distribution for the given arguments Alpha and Beta. +Alpha is a strictly positive parameter of the Beta distribution. +Beta is a strictly positive parameter of the Beta distribution. +Start (optional) is the lower bound of the output range of the function. If omitted, the default value is 0. +End (optional) is the upper bound of the output range of the function. If omitted, the default value is 1. + + +=BETAINV(0.5;5;10) returns the value 0.3257511553. +BETAINV Wiki page +
+ +
+ +BETA.INV function +cumulative probability density function;inverse of + +mw added one entry + + +

BETA.INV

+Returns the inverse of the cumulative Beta probability density function. + +BETA.INV(Number; Alpha; Beta [; Start [; End]]) +Number is the probability associated with the Beta distribution for the given arguments Alpha and Beta. +Alpha is a strictly positive parameter of the Beta distribution. +Beta is a strictly positive parameter of the Beta distribution. +Start (optional) is the lower bound of the output range of the function. If omitted, the default value is 0. +End (optional) is the upper bound of the output range of the function. If omitted, the default value is 1. + + +=BETA.INV(0.5;5;10) returns the value 0.3257511553. +BETA.INV Wiki page + + + +COM.MICROSOFT.BETA.INV +
+ +
+ + BETADIST function + cumulative probability density function;calculating + +mw added one entry + + +

BETADIST

+Returns the beta function. + + +BETADIST(Number; Alpha; Beta [; Start [; End [; Cumulative]]]) +Number is the value between Start and End at which to evaluate the function. +Alpha is a parameter to the distribution. +Beta is a parameter to the distribution. +Start (optional) is the lower bound for Number. +End (optional) is the upper bound for Number. +Cumulative (optional) can be 0 or False to calculate the probability density function. It can be any other value or True or omitted to calculate the cumulative distribution function. + + + +=BETADIST(0.75;3;4) returns the value 0.96. +
+ +
+ + BETA.DIST function + cumulative probability density function;calculating + +mw added one entry + + +

BETA.DIST

+Returns the beta function. + + +BETA.DIST(Number; Alpha; Beta; Cumulative [; Start [; End]]) +Number (required) is the value between Start and End at which to evaluate the function. +Alpha (required) is a parameter to the distribution. +Beta (required) is a parameter to the distribution. +Cumulative (required) can be 0 or False to calculate the probability density function. It can be any other value or True to calculate the cumulative distribution function. +Start (optional) is the lower bound for Number. +End (optional) is the upper bound for Number. + + + +=BETA.DIST(2;8;10;1;1;3) returns the value 0.6854706 +=BETA.DIST(2;8;10;0;1;3) returns the value 1.4837646 + + +COM.MICROSOFT.BETA.DIST +
+ +
+ + BINOMDIST function + + + + +

BINOMDIST

+Returns the individual term binomial distribution probability. + + +BINOMDIST(X; Trials; SP; C) +X is the number of successes in a set of trials. +Trials is the number of independent trials. +SP is the probability of success on each trial. +C = 0 calculates the probability of a single event and C = 1 calculates the cumulative probability. + + +=BINOMDIST(A1;12;0.5;0) shows (if the values 0 to 12 are entered in A1) the probabilities for 12 flips of a coin that Heads will come up exactly the number of times entered in A1. +=BINOMDIST(A1;12;0.5;1) shows the cumulative probabilities for the same series. For example, if A1 = 4, the cumulative probability of the series is 0, 1, 2, 3 or 4 times Heads (non-exclusive OR). +
+ +
+ + BINOM.DIST function + + + + +

BINOM.DIST

+Returns the individual term binomial distribution probability. + +BINOM.DIST(X; Trials; SP; C) +X is the number of successes in a set of trials. +Trials is the number of independent trials. +SP is the probability of success on each trial. +C = 0 calculates the probability of a single event and C = 1 calculates the cumulative probability. + + +=BINOM.DIST(A1;12;0.5;0) shows (if the values 0 to 12 are entered in A1) the probabilities for 12 flips of a coin that Heads will come up exactly the number of times entered in A1. +=BINOM.DIST(A1;12;0.5;1) shows the cumulative probabilities for the same series. For example, if A1 = 4, the cumulative probability of the series is 0, 1, 2, 3 or 4 times Heads (non-exclusive OR). + + + +COM.MICROSOFT.BINOM.DIST +
+ +
+ + BINOM.INV function + + + + +

BINOM.INV

+Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value. + +BINOM.INV(Trials; SP; Alpha) +Trials The total number of trials. +SP is the probability of success on each trial. +Alpha The border probability that is attained or exceeded. + + +=BINOM.INV(8;0.6;0.9) returns 7, the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value. + + + +COM.MICROSOFT.BINOM.INV +
+ +
+ + + CHISQINV function + + +

CHISQINV

+Returns the inverse of CHISQDIST. + +CHISQINV(Probability; Degrees of Freedom) +Probability is the probability value for which the inverse of the chi-square distribution is to be calculated. +Degrees Of Freedom is the degrees of freedom for the chi-square function. +
+ +
+ + + CHISQ.INV function + + + +

CHISQ.INV

+Returns the inverse of the left-tailed probability of the chi-square distribution. + +CHISQ.INV(Probability; DegreesFreedom) +Probability is the probability value for which the inverse of the chi-square distribution is to be calculated. +Degrees Of Freedom is the degrees of freedom for the chi-square function. + + +=CHISQ.INV(0,5;1) returns 0.4549364231. + + + +COM.MICROSOFT.CHISQ.INV +
+ +
+ + CHIINV function + + + + +

CHIINV

+Returns the inverse of the one-tailed probability of the chi-squared distribution. + + +CHIINV(Number; DegreesFreedom) +Number is the value of the error probability. +DegreesFreedom is the degrees of freedom of the experiment. + + +A die is thrown 1020 times. The numbers on the die 1 through 6 come up 195, 151, 148, 189, 183 and 154 times (observation values). The hypothesis that the die is not fixed is to be tested. +The Chi square distribution of the random sample is determined by the formula given above. Since the expected value for a given number on the die for n throws is n times 1/6, thus 1020/6 = 170, the formula returns a Chi square value of 13.27. +If the (observed) Chi square is greater than or equal to the (theoretical) Chi square CHIINV, the hypothesis will be discarded, since the deviation between theory and experiment is too great. If the observed Chi square is less that CHIINV, the hypothesis is confirmed with the indicated probability of error. +=CHIINV(0.05;5) returns 11.07. +=CHIINV(0.02;5) returns 13.39. +If the probability of error is 5%, the die is not true. If the probability of error is 2%, there is no reason to believe it is fixed. +
+ +
+ + CHISQ.INV.RT function + + + + +

CHISQ.INV.RT

+Returns the inverse of the one-tailed probability of the chi-squared distribution. + +CHISQ.INV.RT(Number; DegreesFreedom) +Number is the value of the error probability. +DegreesFreedom is the degrees of freedom of the experiment. + + +A die is thrown 1020 times. The numbers on the die 1 through 6 come up 195, 151, 148, 189, 183 and 154 times (observation values). The hypothesis that the die is not fixed is to be tested. +The Chi square distribution of the random sample is determined by the formula given above. Since the expected value for a given number on the die for n throws is n times 1/6, thus 1020/6 = 170, the formula returns a Chi square value of 13.27. +If the (observed) Chi square is greater than or equal to the (theoretical) Chi square CHIINV, the hypothesis will be discarded, since the deviation between theory and experiment is too great. If the observed Chi square is less that CHIINV, the hypothesis is confirmed with the indicated probability of error. +=CHISQ.INV.RT(0.05;5) returns 11.0704976935. +=CHISQ.INV.RT(0.02;5) returns 13.388222599. +If the probability of error is 5%, the die is not true. If the probability of error is 2%, there is no reason to believe it is fixed. + + + +COM.MICROSOFT.CHISQ.INV.RT +
+ +
+ + CHITEST function + + + + +

CHITEST

+Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence. CHITEST returns the chi-squared distribution of the data. +The probability determined by CHITEST can also be determined with CHIDIST, in which case the Chi square of the random sample must then be passed as a parameter instead of the data row. + + +CHITEST(DataB; DataE) +DataB is the array of the observations. +DataE is the range of the expected values. + + + + + +=CHITEST(A1:A6;B1:B6) equals 0.02. This is the probability which suffices the observed data of the theoretical Chi-square distribution. +
+ +
+ + CHISQ.TEST function + + + + +

CHISQ.TEST

+Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence. CHISQ.TEST returns the chi-squared distribution of the data. +The probability determined by CHISQ.TEST can also be determined with CHISQ.DIST, in which case the Chi square of the random sample must then be passed as a parameter instead of the data row. + +CHISQ.TEST(DataB; DataE) +DataB is the array of the observations. +DataE is the range of the expected values. + + +
+ + + + + + Data_B (observed) + + + Data_E (expected) + + + + + 1 + + + 195 + + + 170 + + + + + 2 + + + 151 + + + 170 + + + + + 3 + + + 148 + + + 170 + + + + + 4 + + + 189 + + + 170 + + + + + 5 + + + 183 + + + 170 + + + + + 6 + + + 154 + + + 170 + + +
+
+=CHISQ.TEST(A1:A6;B1:B6) equals 0.0209708029. This is the probability which suffices the observed data of the theoretical Chi-square distribution. + + + +COM.MICROSOFT.CHISQ.TEST +
+ +
+ + CHIDIST function + + + + +

CHIDIST

+Returns the probability value from the indicated Chi square that a hypothesis is confirmed. CHIDIST compares the Chi square value to be given for a random sample that is calculated from the sum of (observed value-expected value)^2/expected value for all values with the theoretical Chi square distribution and determines from this the probability of error for the hypothesis to be tested. +The probability determined by CHIDIST can also be determined by CHITEST. + + +CHIDIST(Number; DegreesFreedom) +Number is the chi-square value of the random sample used to determine the error probability. +DegreesFreedom are the degrees of freedom of the experiment. + + +=CHIDIST(13.27; 5) equals 0.02. +If the Chi square value of the random sample is 13.27 and if the experiment has 5 degrees of freedom, then the hypothesis is assured with a probability of error of 2%. +
+ +
+ + CHISQ.DIST function + + + + +

CHISQ.DIST

+Returns the probability density function or the cumulative distribution function for the chi-square distribution. + +CHISQ.DIST(Number; DegreesFreedom; Cumulative) +Number is the chi-square value of the random sample used to determine the error probability. +DegreesFreedom are the degrees of freedom of the experiment. +Cumulative can be 0 or False to calculate the probability density function. It can be any other value or True to calculate the cumulative distribution function. + + +=CHISQ.DIST(3; 2; 0) equals 0.1115650801, the probability density function with 2 degrees of freedom, at x = 3. +=CHISQ.DIST(3; 2; 1) equals 0.7768698399, the cumulative chi-square distribution with 2 degrees of freedom, at the value x = 3. + + + +COM.MICROSOFT.CHISQ.DIST +
+ +
+ + CHISQ.DIST.RT function + + + + +

CHISQ.DIST.RT

+Returns the probability value from the indicated Chi square that a hypothesis is confirmed. CHISQ.DIST.RT compares the Chi square value to be given for a random sample that is calculated from the sum of (observed value-expected value)^2/expected value for all values with the theoretical Chi square distribution and determines from this the probability of error for the hypothesis to be tested. +The probability determined by CHISQ.DIST.RT can also be determined by CHITEST. + +CHISQ.DIST.RT(Number; DegreesFreedom) +Number is the chi-square value of the random sample used to determine the error probability. +DegreesFreedom are the degrees of freedom of the experiment. + + +=CHISQ.DIST.RT(13.27; 5) equals 0.0209757694. +If the Chi square value of the random sample is 13.27 and if the experiment has 5 degrees of freedom, then the hypothesis is assured with a probability of error of 2%. + + + +COM.MICROSOFT.CHISQ.DIST.RT +
+ +
+ + + CHISQDIST function + chi-square distribution + + + +

CHISQDIST

+Returns the value of the probability density function or the cumulative distribution function for the chi-square distribution. + + +CHISQDIST(Number; Degrees Of Freedom [; Cumulative]) +Number is the number for which the function is to be calculated. +Degrees Of Freedom is the degrees of freedom for the chi-square function. +Cumulative (optional): 0 or False calculates the probability density function. Other values or True or omitted calculates the cumulative distribution function. +
+ +
+ + EXPONDIST function + exponential distributions + + + + +

EXPONDIST

+Returns the exponential distribution. + + +EXPONDIST(Number; Lambda; C) +Number is the value of the function. +Lambda is the parameter value.UFI removed a double bookmark +C is a logical value that determines the form of the function. C = 0 calculates the density function, and C = 1 calculates the distribution. + + +=EXPONDIST(3;0.5;1) returns 0.78. +
+ +
+ + EXPON.DIST function + exponential distributions + + + + +

EXPON.DIST

+Returns the exponential distribution. + +EXPON.DIST(Number; Lambda; C) +Number is the value of the function. +Lambda is the parameter value.UFI removed a double bookmark +C is a logical value that determines the form of the function. C = 0 calculates the density function, and C = 1 calculates the distribution. + + +=EXPON.DIST(3;0.5;1) returns 0.7768698399. + + + +COM.MICROSOFT.EXPON.DIST +
+ + +
+ +
+ + + diff --git a/helpcontent2/source/text/scalc/01/04060182.xhp b/helpcontent2/source/text/scalc/01/04060182.xhp new file mode 100644 index 000000000..8591243a9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060182.xhp @@ -0,0 +1,496 @@ + + + + + + + Statistical Functions Part Two + /text/scalc/01/04060182.xhp + + + +

Statistical Functions Part Two +

+ +
+FINV function + inverse F probability distribution +mw added one entry + +

FINV

+ Returns the inverse of the F probability distribution. The F distribution is used for F tests in order to set the relation between two differing data sets. + + FINV(Number; DegreesFreedom1; DegreesFreedom2) + + Number is probability value for which the inverse F distribution is to be calculated. + + DegreesFreedom1 is the number of degrees of freedom in the numerator of the F distribution. + + DegreesFreedom2 is the number of degrees of freedom in the denominator of the F distribution. + + + =FINV(0.5;5;10) yields 0.93. +
+
+ + F.INV function + Values of the inverse left tail of the F distribution + + mw added one entry + +

F.INV

+ Returns the inverse of the cumulative F distribution. The F distribution is used for F tests in order to set the relation between two differing data sets. + + F.INV(Number; DegreesFreedom1; DegreesFreedom2) + Number is probability value for which the inverse F distribution is to be calculated. + DegreesFreedom1 is the number of degrees of freedom in the numerator of the F distribution. + DegreesFreedom2 is the number of degrees of freedom in the denominator of the F distribution. + + =F.INV(0.5;5;10) yields 0.9319331609. + + + + COM.MICROSOFT.F.INV +
+
+ + F.INV.RT function + Values of the inverse right tail of the F distribution + + mw added one entry + +

F.INV.RT

+ Returns the inverse right tail of the F distribution. + + F.INV.RT(Number; DegreesFreedom1; DegreesFreedom2) + Number is probability value for which the inverse F distribution is to be calculated. + DegreesFreedom1 is the number of degrees of freedom in the numerator of the F distribution. + DegreesFreedom2 is the number of degrees of freedom in the denominator of the F distribution. + + =F.INV.RT(0.5;5;10) yields 0.9319331609. + + + + COM.MICROSOFT.F.INV.RT +
+
+FISHER function + + +

FISHER

+ Returns the Fisher transformation for x and creates a function close to a normal distribution. + + FISHER(Number) + + Number is the value to be transformed. + + + =FISHER(0.5) yields 0.55. +
+
+FISHERINV function + inverse of Fisher transformation +mw added one entry + +

FISHERINV

+ Returns the inverse of the Fisher transformation for x and creates a function close to a normal distribution. + + FISHERINV(Number) + + Number is the value that is to undergo reverse-transformation. + + + =FISHERINV(0.5) yields 0.46. +
+
+FTEST function + + +

FTEST

+ Returns the result of an F test. + + FTEST(Data1; Data2) + + Data1 is the first record array. + + Data2 is the second record array. + + + + =FTEST(A1:A30;B1:B12) calculates whether the two data sets are different in their variance and returns the probability that both sets could have come from the same total population. +
+
+ + F.TEST function + + +

F.TEST

+ Returns the result of an F test. + + F.TEST(Data1; Data2) + Data1 is the first record array. + Data2 is the second record array. + + =F.TEST(A1:A30;B1:B12) calculates whether the two data sets are different in their variance and returns the probability that both sets could have come from the same total population. + + + + COM.MICROSOFT.F.TEST +
+
+FDIST function + + +

FDIST

+ Calculates the values of an F distribution. + + FDIST(Number; DegreesFreedom1; DegreesFreedom2) + + Number is the value for which the F distribution is to be calculated. + + degreesFreedom1 is the degrees of freedom in the numerator in the F distribution. + + degreesFreedom2 is the degrees of freedom in the denominator in the F distribution. + + + =FDIST(0.8;8;12) yields 0.61. +
+
+ + F.DIST function + + +

F.DIST

+ Calculates the values of the left tail of the F distribution. + + F.DIST(Number; DegreesFreedom1; DegreesFreedom2 [; Cumulative]) + Number is the value for which the F distribution is to be calculated. + degreesFreedom1 is the degrees of freedom in the numerator in the F distribution. + degreesFreedom2 is the degrees of freedom in the denominator in the F distribution. + Cumulative = 0 or False calculates the density function Cumulative = 1 or True calculates the distribution. + + =F.DIST(0.8;8;12;0) yields 0.7095282499. + =F.DIST(0.8;8;12;1) yields 0.3856603563. + + + + COM.MICROSOFT.F.DIST +
+
+ + F.DIST.RT function + + +

F.DIST.RT

+ Calculates the values of the right tail of the F distribution. + + F.DIST.RT(Number; DegreesFreedom1; DegreesFreedom2) + Number is the value for which the F distribution is to be calculated. + degreesFreedom1 is the degrees of freedom in the numerator in the F distribution. + degreesFreedom2 is the degrees of freedom in the denominator in the F distribution. + + =F.DIST.RT(0.8;8;12) yields 0.6143396437. + + + + COM.MICROSOFT.F.DIST.RT +
+
+ +GAMMA function + +

GAMMA

+ Returns the Gamma function value. Note that GAMMAINV is not the inverse of GAMMA, but of GAMMADIST. + + GAMMA(Number) + + Number is the number for which the Gamma function value is to be calculated. +
+
+GAMMAINV function + + +

GAMMAINV

+ Returns the inverse of the Gamma cumulative distribution GAMMADIST. This function allows you to search for variables with different distribution. + + GAMMAINV(Number; Alpha; Beta) + + Number is the probability value for which the inverse Gamma distribution is to be calculated. + + Alpha is the parameter Alpha of the Gamma distribution. + + Beta is the parameter Beta of the Gamma distribution. + + + =GAMMAINV(0.8;1;1) yields 1.61. +
+
+GAMMA.INV function + + +

GAMMA.INV

+ Returns the inverse of the Gamma cumulative distribution GAMMADIST. This function allows you to search for variables with different distribution. + This function is identical to GAMMAINV and was introduced for interoperability with other office suites. + + GAMMA.INV(Number; Alpha; Beta) + + Number is the probability value for which the inverse Gamma distribution is to be calculated. + + Alpha is the parameter Alpha of the Gamma distribution. + + Beta is the parameter Beta of the Gamma distribution. + + + =GAMMA.INV(0.8;1;1) yields 1.61. + + + + COM.MICROSOFT.GAMMA.INV +
+
+GAMMALN function + natural logarithm of Gamma function +mw added one entry + +

GAMMALN

+ Returns the natural logarithm of the Gamma function: G(x). + + GAMMALN(Number) + + Number is the value for which the natural logarithm of the Gamma function is to be calculated. + + + =GAMMALN(2) yields 0. +
+
+GAMMALN.PRECISE function + natural logarithm of Gamma function +mw added one entry + +

GAMMALN.PRECISE

+ Returns the natural logarithm of the Gamma function: G(x). + + GAMMALN.PRECISE(Number) + + Number is the value for which the natural logarithm of the Gamma function is to be calculated. + + + =GAMMALN.PRECISE(2) yields 0. + + + + COM.MICROSOFT.GAMMALN.PRECISE +
+
+GAMMADIST function + + +

GAMMADIST

+ Returns the values of a Gamma distribution. + The inverse function is GAMMAINV. + + GAMMADIST(Number; Alpha; Beta [; C]) + + Number is the value for which the Gamma distribution is to be calculated. + + Alpha is the parameter Alpha of the Gamma distribution. + + Beta is the parameter Beta of the Gamma distribution. + + C (optional) = 0 or False calculates the density function C = 1 or True calculates the distribution. + + + =GAMMADIST(2;1;1;1) yields 0.86. +
+
+ +GAMMA.DIST function + + +

GAMMA.DIST

+Returns the values of a Gamma distribution. +The inverse function is GAMMAINV or GAMMA.INV. +This function is similar to GAMMADIST and was introduced for interoperability with other office suites. + +GAMMA.DIST(Number; Alpha; Beta; Cumulative) +Number is the value for which the Gamma distribution is to be calculated. +Alpha is the parameter Alpha of the Gamma distribution. +Beta is the parameter Beta of the Gamma distribution. +Cumulative = 0 or False calculates the probability density function; Cumulative = 1, True, or any other value calculates the cumulative distribution function. + +=GAMMA.DIST(2;1;1;1) yields 0.86. + + + +COM.MICROSOFT.GAMMA.DIST +
+
+GAUSS function + normal distribution; standard +mw added one entry + +

GAUSS

+ Returns the standard normal cumulative distribution. + It is GAUSS(x)=NORMSDIST(x)-0.5 + + GAUSS(Number) + + Number is the value for which the value of the standard normal distribution is to be calculated. + + + =GAUSS(0.19) = 0.08 + + =GAUSS(0.0375) = 0.01 +
+
+GEOMEAN function + means;geometric +mw added one entry + +

GEOMEAN

+ Returns the geometric mean of a sample. + + GEOMEAN() + + + + + =GEOMEAN(23;46;69) = 41.79. The geometric mean value of this random sample is therefore 41.79. +
+
+TRIMMEAN function + means;of data set without margin data +mw added one entry + +

TRIMMEAN

+ Returns the mean of a data set without the Alpha percent of data at the margins. + + TRIMMEAN(Data; Alpha) + + Data is the array of data in the sample. + + Alpha is the percentage of the marginal data that will not be taken into consideration. + + + + =TRIMMEAN(A1:A50; 0.1) calculates the mean value of numbers in A1:A50, without taking into consideration the 5 percent of the values representing the highest values and the 5 percent of the values representing the lowest ones. The percentage numbers refer to the amount of the untrimmed mean value, not to the number of summands. +
+
+ZTEST function + + +

ZTEST

+ Calculates the probability of observing a z-statistic greater than the one computed based on a sample. + + ZTEST(Data; mu [; Sigma]) + + Data is the given sample, drawn from a normally distributed population. + + mu is the known mean of the population. + + Sigma (optional) is the known standard deviation of the population. If omitted, the standard deviation of the given sample is used. + See also the Wiki page. + +
+
+Z.TEST function + + +

Z.TEST

+Calculates the probability of observing a z-statistic greater than the one computed based on a sample. + +Z.TEST(Data; mu [; Sigma]) +Data is the given sample, drawn from a normally distributed population. +mu is the known mean of the population. +Sigma (optional) is the known standard deviation of the population. If omitted, the standard deviation of the given sample is used. + +=Z.TEST(A2:A20; 9; 2) returns the result of a z-test on a sample A2:A20 drawn from a population with known mean 9 and known standard deviation 2. + + + +COM.MICROSOFT.Z.TEST +
+
+HARMEAN function + means;harmonic +mw added one entry + +

HARMEAN

+ Returns the harmonic mean of a data set. + + HARMEAN() + + + + + =HARMEAN(23;46;69) = 37.64. The harmonic mean of this random sample is thus 37.64 +
+
+HYPGEOMDIST function + sampling without replacement +mw added one entry + +

HYPGEOMDIST

+ Returns the hypergeometric distribution. + + + HYPGEOMDIST(X; NSample; Successes; NPopulation [; Cumulative]) + + X is the number of results achieved in the random sample. + + NSample is the size of the random sample. + + Successes is the number of possible results in the total population. + + NPopulation is the size of the total population. + Cumulative (optional) specifies whether to calculate the probability mass function (FALSE or 0) or the cumulative distribution function (any other value). The probability mass function is the default if no value is specified for this parameter. + + + =HYPGEOMDIST(2;2;90;100) yields 0.81. If 90 out of 100 pieces of buttered toast fall from the table and hit the floor with the buttered side first, then if 2 pieces of buttered toast are dropped from the table, the probability is 81%, that both will strike buttered side first. +
+
+ + HYPGEOM.DIST function + sampling without replacement + + mw added one entry + +

HYPGEOM.DIST

+ Returns the hypergeometric distribution. + + HYPGEOM.DIST(X; NSample; Successes; NPopulation; Cumulative) + X is the number of results achieved in the random sample. + NSample is the size of the random sample. + Successes is the number of possible results in the total population. + NPopulation is the size of the total population. + Cumulative : 0 or False calculates the probability density function. Other values or True calculates the cumulative distribution function. + + =HYPGEOM.DIST(2;2;90;100;0) yields 0.8090909091. If 90 out of 100 pieces of buttered toast fall from the table and hit the floor with the buttered side first, then if 2 pieces of buttered toast are dropped from the table, the probability is 81%, that both will strike buttered side first. + =HYPGEOM.DIST(2;2;90;100;1) yields 1. + + + + COM.MICROSOFT.HYPGEOM.DIST +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060183.xhp b/helpcontent2/source/text/scalc/01/04060183.xhp new file mode 100644 index 000000000..41b9d69ea --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060183.xhp @@ -0,0 +1,326 @@ + + + + + + + +Statistical Functions Part Three +/text/scalc/01/04060183.xhp + + + +

Statistical Functions Part Three +

+ +
+LARGE function + + +

LARGE

+Returns the Rank_c-th largest value in a data set. + + +LARGE(Data; RankC) +Data is the cell range of data. +RankC is the ranking of the value. If RankC is an array, the function becomes an array function. + + +=LARGE(A1:C50;2) gives the second largest value in A1:C50. +=LARGE(A1:C50;B1:B5) entered as an array function gives an array of the c-th largest value in A1:C50 with ranks defined in B1:B5. +
+
+SMALL function + + +

SMALL

+Returns the Rank_c-th smallest value in a data set. + + +SMALL(Data; RankC) +Data is the cell range of data. +RankC is the rank of the value. If RankC is an array, the function becomes an array function. + + +=SMALL(A1:C50;2) gives the second smallest value in A1:C50. +=SMALL(A1:C50;B1:B5) entered as an array function gives an array of the c-th smallest value in A1:C50 with ranks defined in B1:B5. +
+
+CONFIDENCE function + + +

CONFIDENCE

+Returns the (1-alpha) confidence interval for a normal distribution. + +CONFIDENCE(Alpha; StDev; Size) + +Alpha is the level of the confidence interval. + +StDev is the standard deviation for the total population. + +Size is the size of the total population. + + +=CONFIDENCE(0.05;1.5;100) gives 0.29. +
+
+CONFIDENCE.T function + + +

CONFIDENCE.T

+ + Returns the (1-alpha) confidence interval for a Student's t distribution. + +CONFIDENCE.T(Alpha; StDev; Size) + +Alpha is the level of the confidence interval. + +StDev is the standard deviation for the total population. + +Size is the size of the total population. + + +=CONFIDENCE.T(0.05;1.5;100) gives 0.2976325427. + + + +COM.MICROSOFT.CONFIDENCE.T +
+
+CONFIDENCE.NORM function + + +

CONFIDENCE.NORM

+ + Returns the (1-alpha) confidence interval for a normal distribution. + +CONFIDENCE.NORM(Alpha; StDev; Size) + +Alpha is the level of the confidence interval. + +StDev is the standard deviation for the total population. + +Size is the size of the total population. + + +=CONFIDENCE.NORM(0.05;1.5;100) gives 0.2939945977. + + + +COM.MICROSOFT.CONFIDENCE.NORM +
+
+CORREL function +coefficient of correlation +mw added one entry + +

CORREL

+Returns the correlation coefficient between two data sets. + +CORREL(Data1; Data2) + +Data1 is the first data set. + +Data2 is the second data set. + + +=CORREL(A1:A50;B1:B50) calculates the correlation coefficient as a measure of the linear correlation of the two data sets. +
+
+COVAR function + + +

COVAR

+Returns the covariance of the product of paired deviations. + +COVAR(Data1; Data2) + +Data1 is the first data set. + +Data2 is the second data set. + + +=COVAR(A1:A30;B1:B30) + +
+
+ + COVARIANCE.P function + + +

COVARIANCE.P

+ Returns the covariance of the product of paired deviations, for the entire population. + + COVARIANCE.P(Data1; Data2) + Data1 is the first data set. + Data2 is the second data set. + + =COVARIANCE.P(A1:A30;B1:B30) + + + + COM.MICROSOFT.COVARIANCE.P +
+
+ + COVARIANCE.S function + + +

COVARIANCE.S

+ Returns the covariance of the product of paired deviations, for a sample of the population. + + COVARIANCE.S(Data1; Data2) + Data1 is the first data set. + Data2 is the second data set. + + =COVARIANCE.S(A1:A30;B1:B30) + + + + COM.MICROSOFT.COVARIANCE.S +
+
+CRITBINOM function + + +

CRITBINOM

+Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value. + +CRITBINOM(Trials; SP; Alpha) + +Trials is the total number of trials. + +SP is the probability of success for one trial. + +Alpha is the threshold probability to be reached or exceeded. + + +=CRITBINOM(100;0.5;0.1) yields 44. +
+
+KURT function + + +

KURT

+Returns the kurtosis of a data set (at least 4 values required). + +KURT() + +The parameters should specify at least four values. + + + +=KURT(A1;A2;A3;A4;A5;A6) + +
+
+LOGINV function +inverse of lognormal distribution +mw added one entry + +

LOGINV

+Returns the inverse of the lognormal distribution. + +LOGINV(Number [; Mean [; StDev]]) + +Number (required) is the probability value for which the inverse standard logarithmic distribution is to be calculated. + +Mean (optional) is the arithmetic mean of the standard logarithmic distribution (defaults to 0 if omitted). + +StDev (optional) is the standard deviation of the standard logarithmic distribution (defaults to 1 if omitted). + + +=LOGINV(0.05;0;1) returns 0.1930408167. +
+
+LOGNORM.INV function +inverse of lognormal distribution +mw added one entry + +

LOGNORM.INV

+Returns the inverse of the lognormal distribution. +This function is identical to LOGINV and was introduced for interoperability with other office suites. + +LOGNORM.INV(Number ; Mean ; StDev) + +Number (required) is the probability value for which the inverse standard logarithmic distribution is to be calculated. + +Mean (required) is the arithmetic mean of the standard logarithmic distribution. + +StDev (required) is the standard deviation of the standard logarithmic distribution. + + +=LOGNORM.INV(0.05;0;1) returns 0.1930408167. + + + +COM.MICROSOFT.LOGNORM.INV +
+
+LOGNORMDIST function +lognormal distribution +mw added one entry + +

LOGNORMDIST

+Returns the values of a lognormal distribution. + +LOGNORMDIST(Number [; Mean [; StDev [; Cumulative]]]) + +Number is the probability value for which the standard logarithmic distribution is to be calculated. + +Mean (optional) is the mean value of the standard logarithmic distribution. + +StDev (optional) is the standard deviation of the standard logarithmic distribution. + +Cumulative (optional) = 0 calculates the density function, Cumulative = 1 calculates the distribution. + + +=LOGNORMDIST(0.1;0;1) returns 0.01. +
+
+LOGNORM.DIST function +lognormal distribution +mw added one entry + +

LOGNORM.DIST

+Returns the values of a lognormal distribution. + +LOGNORM.DIST(Number; Mean; StDev; Cumulative) + +Number (required) is the probability value for which the standard logarithmic distribution is to be calculated. + +Mean (required) is the mean value of the standard logarithmic distribution. + +StDev (required) is the standard deviation of the standard logarithmic distribution. + +Cumulative (required) = 0 calculates the density function, Cumulative = 1 calculates the distribution. + + +=LOGNORM.DIST(0.1;0;1;1) returns 0.0106510993. + + + +COM.MICROSOFT.LOGNORM.DIST +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060184.xhp b/helpcontent2/source/text/scalc/01/04060184.xhp new file mode 100644 index 000000000..c3fb40e19 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060184.xhp @@ -0,0 +1,561 @@ + + + + + + +Statistical Functions Part Four +/text/scalc/01/04060184.xhp + + + +

Statistical Functions Part Four +

+ +
+MAX function + + +

MAX

+Returns the maximum value in a list of arguments. +Returns 0 if no numeric value and no error was encountered in the cell range(s) passed as cell reference(s). Text cells are ignored by MIN() and MAX(). The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. Passing a literal string argument to MIN() or MAX(), e.g. MIN("string"), still results in an error. + +MAX() + + + + +=MAX(A1;A2;A3;50;100;200) returns the largest value from the list. + +=MAX(A1:B100) returns the largest value from the list. +
+
+MAXA function + + +

MAXA

+Returns the maximum value in a list of arguments. In opposite to MAX, here you can enter text. The value of the text is 0. +The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. + +MAXA() + + + +=MAXA(A1;A2;A3;50;100;200;"Text") returns the largest value from the list. + +=MAXA(A1:B100) returns the largest value from the list. +
+
+MEDIAN function + + +

MEDIAN

+Returns the median of a set of numbers. In a set containing an uneven number of values, the median will be the number in the middle of the set and in a set containing an even number of values, it will be the mean of the two values in the middle of the set. + +MEDIAN() + + + +for an odd number: =MEDIAN(1;5;9;20;21) returns 9 as the median value. +for an even number: =MEDIAN(1;5;9;20) returns the average of the two middle values 5 and 9, thus 7. +
+
+MIN function + + +

MIN

+Returns the minimum value in a list of arguments. +Returns 0 if no numeric value and no error was encountered in the cell range(s) passed as cell reference(s). Text cells are ignored by MIN() and MAX(). The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. Passing a literal string argument to MIN() or MAX(), e.g. MIN("string"), still results in an error. + +MIN() + + + + +=MIN(A1:B100) returns the smallest value in the list. +
+
+MINA function + + +

MINA

+Returns the minimum value in a list of arguments. Here you can also enter text. The value of the text is 0. +The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. + +MINA() + + + +=MINA(1;"Text";20) returns 0. + +=MINA(A1:B100) returns the smallest value in the list. +
+
+AVEDEV function +averages;statistical functions +mw added "averages;" + +

AVEDEV

+Returns the average of the absolute deviations of data points from their mean. Displays the diffusion in a data set. + +AVEDEV() + + + +=AVEDEV(A1:A50) +
+
+AVERAGE function + + +

AVERAGE

+Returns the average of the arguments. + +AVERAGE() + + + + +=AVERAGE(A1:A50) + +
+
+AVERAGEA function + + +

AVERAGEA

+Returns the average of the arguments. The value of a text is 0. + +AVERAGEA() + + + +=AVERAGEA(A1:A50) + +
+
+

+ +
+
+

+ +
+
+MODE function +most common value +mw added one entry + +

MODE

+Returns the most common value in a data set. If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice. + + +MODE() + + + + +=MODE(A1:A50) + +
+ +
+MODE.SNGL function +most common value +mw added one entry + +

MODE.SNGL

+Returns the most frequently occurring, or repetitive, value in an array or range of data. If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice. + +MODE.SNGL() + +If the data set contains no duplicate data points, MODE.SNGL returns the #VALUE! error value. + +=MODE.SNGL(A1:A50) + + + +COM.MICROSOFT.MODE.SNGL +
+
+MODE.MULT function +most common value +mw added one entry + +

MODE.MULT

+Returns a vertical array of the statistical modes (the most frequently occurring values) within a list of supplied numbers. + +MODE.MULT() + +As the MODE.MULT function returns an array of values, it must be entered as an array formula. If the function is not entered as an array formula, only the first mode is returned, which is the same as using the MODE.SNGL function. + +=MODE.MULT(A1:A50) + + + +COM.MICROSOFT.MODE.MULT +
+
+NEGBINOMDIST function +negative binomial distribution +mw added one entry + +

NEGBINOMDIST

+Returns the negative binomial distribution. + +NEGBINOMDIST(X; R; SP) +X represents the value returned for unsuccessful tests. +R represents the value returned for successful tests. +SP is the probability of the success of an attempt. + + +=NEGBINOMDIST(1;1;0.5) returns 0.25. +
+
+NEGBINOM.DIST function +negative binomial distribution +mw added one entry + +

NEGBINOM.DIST

+Returns the negative binomial density or distribution function. + +NEGBINOM.DIST(X; R; SP; Cumulative) +X represents the value returned for unsuccessful tests. +R represents the value returned for successful tests. +SP is the probability of the success of an attempt. +Cumulative = 0 calculates the density function, Cumulative = 1 calculates the distribution. + +=NEGBINOM.DIST(1;1;0.5;0) returns 0.25. +=NEGBINOM.DIST(1;1;0.5;1) returns 0.75. + + + +COM.MICROSOFT.NEGBINOM.DIST +
+
+NORMINV function +normal distribution;inverse of +mw added one entry + +

NORMINV

+Returns the inverse of the normal cumulative distribution. + +NORMINV(Number; Mean; StDev) +Number represents the probability value used to determine the inverse normal distribution. +Mean represents the mean value in the normal distribution. +StDev represents the standard deviation of the normal distribution. + + +=NORMINV(0.9;63;5) returns 69.41. If the average egg weighs 63 grams with a standard deviation of 5, then there will be 90% probability that the egg will not be heavier than 69.41g grams. +
+
+NORM.INV function +normal distribution;inverse of +mw added one entry + +

NORM.INV

+Returns the inverse of the normal cumulative distribution. + +NORM.INV(Number; Mean; StDev) +Number represents the probability value used to determine the inverse normal distribution. +Mean represents the mean value in the normal distribution. +StDev represents the standard deviation of the normal distribution. + + +=NORM.INV(0.9;63;5) returns 69.4077578277. If the average egg weighs 63 grams with a standard deviation of 5, then there will be 90% probability that the egg will not be heavier than 69.41g grams. + + + +COM.MICROSOFT.NORM.INV +
+
+NORMDIST function +density function +mw added one entry + +

NORMDIST

+Returns the density function or the normal cumulative distribution. + +NORMDIST(Number; Mean; StDev [; C]) +Number is the value of the distribution based on which the normal distribution is to be calculated. +Mean is the mean value of the distribution. +StDev is the standard deviation of the distribution. +C is optional. C = 0 calculates the density function, C = 1 calculates the distribution. + + +=NORMDIST(70;63;5;0) returns 0.03. + +=NORMDIST(70;63;5;1) returns 0.92. +
+
+NORM.DIST function +density function +mw added one entry + +

NORM.DIST

+Returns the density function or the normal cumulative distribution. + +NORM.DIST(Number; Mean; StDev; C) +Number is the value of the distribution based on which the normal distribution is to be calculated. +Mean is the mean value of the distribution. +StDev is the standard deviation of the distribution. +C = 0 calculates the density function, C = 1 calculates the distribution. + + +=NORM.DIST(70;63;5;0) returns 0.029945493. + +=NORM.DIST(70;63;5;1) returns 0.9192433408. + + + +COM.MICROSOFT.NORM.DIST +
+
+PEARSON function + + +

PEARSON

+Returns the Pearson product moment correlation coefficient r. + +PEARSON(Data1; Data2) +Data1 represents the array of the first data set. +Data2 represents the array of the second data set. + + +=PEARSON(A1:A30;B1:B30) returns the Pearson correlation coefficient of both data sets. +
+
+ + PHI function + + +

PHI

+ Returns the value of the probability density function for a given value considering the standard normal distribution. + + PHI(Number) + Number is the value for which the probability density function is calculated. + + + =PHI(2.25) returns 0.0317. + + + =PHI(-2.25) also returns 0.0317 because the normal distribution is symmetrical. + + + =PHI(0) returns 0.3989. + + Calling PHI(Number) is equivalent to calling NORMDIST(Number,0,1,FALSE()) or NORM.S.DIST(Number;FALSE()), hence using the standard normal distribution with mean equal to 0 and standard deviation equal to 1 with the Cumulative argument set to False. +
+
+POISSON function + + +

POISSON

+Returns the Poisson distribution. + +POISSON(Number; Mean [; C]) +Number represents the value based on which the Poisson distribution is calculated. +Mean represents the middle value of the Poisson distribution. +C (optional) = 0 or False calculates the density function; C = 1 or True calculates the distribution. When omitted, the default value True is inserted when you save the document, for best compatibility with other programs and older versions of %PRODUCTNAME. + + +=POISSON(60;50;1) returns 0.93. +
+
+ + POISSON.DIST function + + +

POISSON.DIST

+ Returns the Poisson distribution. + + POISSON.DIST(Number; Mean ; Cumulative) + Number represents the value based on which the Poisson distribution is calculated. + Mean represents the middle value of the Poisson distribution. + Cumulative = 0 or False to calculate the probability mass function; Cumulative = 1, True, or any other non-zero value to calculate the cumulative distribution function. + + =POISSON.DIST(60;50;1) returns 0.9278398202. + + + + COM.MICROSOFT.POISSON.DIST +
+
+PERCENTILE function + + +

PERCENTILE

+Returns the alpha-percentile of data values in an array. A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For Alpha = 25%, the percentile means the first quartile; Alpha = 50% is the MEDIAN. + +PERCENTILE(Data; Alpha) +Data represents the array of data. +Alpha represents the percentage of the scale between 0 and 1. + + + +=PERCENTILE(A1:A50;0.1) represents the value in the data set, which equals 10% of the total data scale in A1:A50. +
+
+PERCENTILE.EXC function + + +

PERCENTILE.EXC

+Returns the Alpha'th percentile of a supplied range of values for a given value of Alpha, within the range 0 to 1 (exclusive). A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (Alpha=1) of a data series. For Alpha = 25%, the percentile means the first quartile; Alpha = 50% is the MEDIAN. +If Alpha is not a multiple of 1/(n+1), (where n is the number of values in the supplied array), the function interpolates between the values in the supplied array, to calculate the percentile value. However, if Alpha is less than 1/(n+1) or Alpha is greater than n/(n+1), the function is unable to interpolate, and so returns an error. +The difference between PERCENTILE.INC and PERCENTILE.EXC is that, in the PERCENTILE.INC function the value of alpha is within the range 0 to 1 inclusive, and in the PERCENTILE.EXC function, the value of alpha is within the range 0 to 1 exclusive. + +PERCENTILE.EXC(Data; Alpha) +Data represents the array of data. +Alpha represents the percentage of the scale between 0 and 1. + +=PERCENTILE.EXC(A1:A50;10%) represents the value in the data set, which equals 10% of the total data scale in A1:A50. + + + +COM.MICROSOFT.PERCENTILE.EXC +
+
+PERCENTILE.INC function + + +

PERCENTILE.INC

+Returns the alpha-percentile of data values in an array. A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For Alpha = 25%, the percentile means the first quartile; Alpha = 50% is the MEDIAN. +The difference between PERCENTILE.INC and PERCENTILE.EXC is that, in the PERCENTILE.INC function the value of alpha is within the range 0 to 1 inclusive, and in the PERCENTILE.EXC function, the value of alpha is within the range 0 to 1 exclusive. + +PERCENTILE.INC(Data; Alpha) +Data represents the array of data. +Alpha represents the percentage of the scale between 0 and 1. + +=PERCENTILE.INC(A1:A50;0.1) represents the value in the data set, which equals 10% of the total data scale in A1:A50. + + + +COM.MICROSOFT.PERCENTILE.INC +
+
+PERCENTRANK function + + +

PERCENTRANK

+Returns the percentage rank of a value in a sample. + +PERCENTRANK(Data; Value [; Significance]) +Data represents the array of data in the sample. +Value represents the value whose percentile rank must be determined. +Significance An optional argument that specifies the number of significant digits that the returned percentage value is rounded to. If omitted, a value of 3 is used. + + + +=PERCENTRANK(A1:A50;50) returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear. +
+
+PERCENTRANK.EXC function + +

PERCENTRANK.EXC

+ Returns the relative position, between 0 and 1 (exclusive), of a specified value within a supplied array. +The difference between PERCENTRANK.INC and PERCENTRANK.EXC is that PERCENTRANK.INC calculates a value in the range 0 to 1 inclusive, whereas the PERCENTRANK.EXC function calculates a value in the range 0 to 1 exclusive. + +PERCENTRANK.EXC(Data; Value [; Significance]) +Data represents the array of data in the sample. +Value represents the value whose percentile rank must be determined. +Significance An optional argument that specifies the number of significant digits that the returned percentage value is rounded to. + +=PERCENTRANK.EXC(A1:A50;50) returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear. + + + +COM.MICROSOFT.PERCENTRANK.EXC +
+
+PERCENTRANK.INC function + +

PERCENTRANK.INC

+Returns the relative position, between 0 and 1 (inclusive), of a specified value within a supplied array. +The difference between PERCENTRANK.INC and PERCENTRANK.EXC is that PERCENTRANK.INC calculates a value in the range 0 to 1 inclusive, whereas the PERCENTRANK.EXC function calculates a value in the range 0 to 1 exclusive. + +PERCENTRANK.INC(Data; Value [; Significance]) +Data represents the array of data in the sample. +Value represents the value whose percentile rank must be determined. +Significance An optional argument that specifies the number of significant digits that the returned percentage value is rounded to. + +=PERCENTRANK.INC(A1:A50;50) returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear. + + + +COM.MICROSOFT.PERCENTRANK.INC +
+
+QUARTILE function + + +

QUARTILE

+Returns the quartile of a data set. + +QUARTILE(Data; Type) +Data represents the array of data in the sample. +Type represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.) + + + +=QUARTILE(A1:A50;2) returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50. +
+
+QUARTILE.EXC function + + +

QUARTILE.EXC

+Returns a requested quartile of a supplied range of values, based on a percentile range of 0 to 1 exclusive. +The difference between QUARTILE.INC and QUARTILE.EXC is that the QUARTILE.INC function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the QUARTILE.EXC function bases its calculation on a percentile range of 0 to 1 exclusive. + +QUARTILE.EXC(Data; Type) +Data represents the range of data values for which you want to calculate the specified quartile. +Type An integer between 1 and 3, representing the required quartile. (if type = 1 or 3, the supplied array must contain more than 2 values) + + +=QUARTILE.EXC(A1:A50;2) returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50. + + + +COM.MICROSOFT.QUARTILE.EXC +
+
+QUARTILE.INC function + + +

QUARTILE.INC

+Returns the quartile of a data set. +The difference between QUARTILE.INC and QUARTILE.EXC is that the QUARTILE.INC function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the QUARTILE.EXC function bases its calculation on a percentile range of 0 to 1 exclusive. + +QUARTILE.INC(Data; Type) +Data represents the array of data in the sample. +Type represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.) + + +=QUARTILE.INC(A1:A50;2) returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50. + + + +COM.MICROSOFT.QUARTILE.INC +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060185.xhp b/helpcontent2/source/text/scalc/01/04060185.xhp new file mode 100644 index 000000000..9223f4a2b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060185.xhp @@ -0,0 +1,786 @@ + + + + + + + + + Statistical Functions Part Five + /text/scalc/01/04060185.xhp + + + +

Statistical Functions Part Five +

+ +
+RANK function + numbers;determining ranks + + +

RANK

+ Returns the rank of a number in a sample. + + RANK(Value; Data [; Type]) + + Value is the value, whose rank is to be determined. + + Data is the array or range of data in the sample. + + Type (optional) is the sequence order. + Type = 0 means descending from the last item of the array to the first (this is the default), + Type = 1 means ascending from the first item of the range to the last. + + + + =RANK(A10;A1:A50) returns the ranking of the value in A10 in value range A1:A50. If Value does not exist within the range an error message is displayed. +
+
+ + RANK.AVG function + numbers;determining ranks + + +

RANK.AVG

+Returns the statistical rank of a given value, within a supplied array of values. If there are duplicate values in the list, the average rank is returned. +The difference between RANK.AVG and RANK.EQ occurs when there are duplicates in the list of values. The RANK.EQ function returns the lower rank, whereas the RANK.AVG function returns the average rank. + +RANK.AVG(Value; Data [; Type]) +Value is the value, whose rank is to be determined. +Data is the array or range of data in the sample. +Type (optional) is the sequence order. +Type = 0 means descending from the last item of the array to the first (this is the default), +Type = 1 means ascending from the first item of the range to the last. + +=RANK.AVG(A10;A1:A50) returns the ranking of the value in A10 in value range A1:A50. If Value does not exist within the range an error message is displayed. + + + +COM.MICROSOFT.RANK.AVG +
+
+ + RANK.EQ function + numbers;determining ranks + + +

RANK.EQ

+Returns the statistical rank of a given value, within a supplied array of values. If there are duplicate values in the list, these are given the same rank. +The difference between RANK.AVG and RANK.EQ occurs when there are duplicates in the list of values. The RANK.EQ function returns the lower rank, whereas the RANK.AVG function returns the average rank. + +RANK.EQ(Value; Data [; Type]) +Value is the value, whose rank is to be determined. +Data is the array or range of data in the sample. +Type (optional) is the sequence order. +Type = 0 means descending from the last item of the array to the first (this is the default), +Type = 1 means ascending from the first item of the range to the last. + +=RANK.EQ(A10;A1:A50) returns the ranking of the value in A10 in value range A1:A50. If Value does not exist within the range an error message is displayed. + + + +COM.MICROSOFT.RANK.EQ +
+
+SKEW function + + +

SKEW

+ Returns the skewness of a distribution. + + + SKEW() + + The parameters should specify at least three values. + + + + =SKEW(A1:A50) calculates the value of skew for the data referenced. +
+
+ +
+
+regression lines;FORECAST function + extrapolations + FORECAST function + +mw made "regression lines" a two level entry +

FORECAST

+ Extrapolates future values based on existing x and y values. + + FORECAST(Value; DataY; DataX) + + Value is the x value, for which the y value on the linear regression is to be returned. + + DataY is the array or range of known y's. + + DataX is the array or range of known x's. + + + =FORECAST(50;A1:A50;B1;B50) returns the Y value expected for the X value of 50 if the X and Y values in both references are linked by a linear trend. +
+
+regression lines;FORECAST.LINEAR function + extrapolations + FORECAST.LINEAR function + + +

FORECAST.LINEAR

+ Extrapolates future values based on existing x and y values. + + FORECAST.LINEAR(Value; DataY; DataX) + + Value is the x value, for which the y value on the linear regression is to be returned. + + DataY is the array or range of known y's. + + DataX is the array or range of known x's. + + + =FORECAST.LINEAR(50;A1:A50;B1;B50) returns the Y value expected for the X value of 50 if the X and Y values in both references are linked by a linear trend. + + + COM.MICROSOFT.FORECAST.LINEAR +
+
+STDEV function + standard deviations in statistics;based on a sample + + +

STDEV

+ Estimates the standard deviation based on a sample. + + STDEV() + + The parameters should specify at least two values. + + + =STDEV(A1:A50) returns the estimated standard deviation based on the data referenced. +
+
+STDEVA function + + +

STDEVA

+ Calculates the standard deviation of an estimation based on a sample. + + + STDEVA() + + The parameters should specify at least two values. Text has the value 0. + + + =STDEVA(A1:A50) returns the estimated standard deviation based on the data referenced. +
+
+STDEVP function + standard deviations in statistics;based on a population + + +

STDEVP

+ Calculates the standard deviation based on the entire population. + + + STDEVP() + + + + + =STDEVP(A1:A50) returns a standard deviation of the data referenced. +
+
+ + STDEV.P function + standard deviations in statistics;based on a population + + +

STDEV.P

+ Calculates the standard deviation based on the entire population. + + + STDEV.P() + + + =STDEV.P(A1:A50) returns a standard deviation of the data referenced. + + + + COM.MICROSOFT.STDEV.P +
+
+ + STDEV.S function + standard deviations in statistics;based on a sample + + +

STDEV.S

+ Calculates the standard deviation based on sample of the population. + + + STDEV.S() + + The parameters should specify at least two values. + + =STDEV.S(A1:A50) returns a standard deviation of the data referenced. + + + + COM.MICROSOFT.STDEV.S +
+
+STDEVPA function + + +

STDEVPA

+ Calculates the standard deviation based on the entire population. + + STDEVPA() + + Text has the value 0. + + + =STDEVPA(A1:A50) returns the standard deviation of the data referenced. +
+
+STANDARDIZE function + converting;random variables, into normalized values + + +

STANDARDIZE

+ Converts a random variable to a normalized value. + + STANDARDIZE(Number; Mean; StDev) + + Number is the value to be standardized. + + Mean is the arithmetic mean of the distribution. + + StDev is the standard deviation of the distribution. + + + =STANDARDIZE(11;10;1) returns 1. The value 11 in a normal distribution with a mean of 10 and a standard deviation of 1 is as much above the mean of 10, as the value 1 is above the mean of the standard normal distribution. +
+
+NORMSINV function + normal distribution;inverse of standard + + +

NORMSINV

+ Returns the inverse of the standard normal cumulative distribution. + + NORMSINV(Number) + + Number is the probability to which the inverse standard normal distribution is calculated. + + + =NORMSINV(0.908789) returns 1.3333. +
+
+NORM.S.INV function + normal distribution;inverse of standard + + +

NORM.S.INV

+ Returns the inverse of the standard normal cumulative distribution. + + NORM.S.INV(Number) + + Number is the probability to which the inverse standard normal distribution is calculated. + + + =NORM.S.INV(0.908789) returns 1.333334673. + + + + COM.MICROSOFT.NORM.S.INV +
+
+NORMSDIST function + normal distribution;statistics + + +

NORMSDIST

+ Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one. + It is GAUSS(x)=NORMSDIST(x)-0.5 + + NORMSDIST(Number) + + Number is the value to which the standard normal cumulative distribution is calculated. + + + =NORMSDIST(1) returns 0.84. The area below the standard normal distribution curve to the left of X value 1 is 84% of the total area. +
+
+NORM.S.DIST function + normal distribution;statistics + + +

NORM.S.DIST

+ Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one. + + NORM.S.DIST(Number; Cumulative) + + Number is the value to which the standard normal cumulative distribution is calculated. + + Cumulative 0 or FALSE calculates the probability density function. Any other value or TRUE calculates the cumulative distribution function. + + + =NORM.S.DIST(1;0) returns 0.2419707245. + + =NORM.S.DIST(1;1) returns 0.8413447461. The area below the standard normal distribution curve to the left of X value 1 is 84% of the total area. + + + + COM.MICROSOFT.NORM.S.DIST +
+
+SLOPE function + + +

SLOPE

+ Returns the slope of the linear regression line. The slope is adapted to the data points set in the y and x values. + + SLOPE(DataY; DataX) + + DataY is the array or matrix of Y data. + + DataX is the array or matrix of X data. + + + =SLOPE(A1:A50;B1:B50) + +
+
+STEYX function + standard errors;statistical functions +mw changed "standard errors" + +

STEYX

+ Returns the standard error of the predicted y value for each x in the regression. + + STEYX(DataY; DataX) + + DataY is the array or matrix of Y data. + + DataX is the array or matrix of X data. + + + =STEYX(A1:A50;B1:B50) + +
+
+DEVSQ function + sums;of squares of deviations + + +

DEVSQ

+ Returns the sum of squares of deviations based on a sample mean. + + DEVSQ() + + + + + =DEVSQ(A1:A50) + +
+
+TINV function + inverse of t-distribution + + +

TINV

+ Returns the inverse of the t-distribution. + + TINV(Number; DegreesFreedom) + + Number is the probability associated with the two-tailed t-distribution. + + DegreesFreedom is the number of degrees of freedom for the t-distribution. + + + =TINV(0.1;6) returns 1.94 +
+
+ + T.INV function + one tailed inverse of t-distribution + + +

T.INV

+ Returns the one tailed inverse of the t-distribution. + + T.INV(Number; DegreesFreedom) + Number is the probability associated with the one-tailed t-distribution. + DegreesFreedom is the number of degrees of freedom for the t-distribution. + + =T.INV(0.1;6) returns -1.4397557473. + + + + COM.MICROSOFT.T.INV +
+
+ + T.INV.2T function + inverse of two tailed t-distribution + + +

T.INV.2T

+ Calculates the inverse of the two-tailed Student's T Distribution , which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets. + + T.INV.2T(Number; DegreesFreedom) + Number is the probability associated with the two-tailed t-distribution. + DegreesFreedom is the number of degrees of freedom for the t-distribution. + + =T.INV.2T(0.25; 10) returns 1.221255395. + + + + COM.MICROSOFT.T.INV.2T +
+
+TTEST function + + +

TTEST

+ Returns the probability associated with a Student's t-Test. + + TTEST(Data1; Data2; Mode; Type) + + Data1 is the dependent array or range of data for the first record. + + Data2 is the dependent array or range of data for the second record. + + Mode = 1 calculates the one-tailed test, Mode = 2 the two- tailed test. + + Type is the kind of t-test to perform. Type 1 means paired. Type 2 means two samples, equal variance (homoscedastic). Type 3 means two samples, unequal variance (heteroscedastic). + + + =TTEST(A1:A50;B1:B50;2;2) + +
+
+ + T.TEST function + + +

T.TEST

+ Returns the probability associated with a Student's t-Test. + + T.TEST(Data1; Data2; Mode; Type) + Data1 is the dependent array or range of data for the first record. + Data2 is the dependent array or range of data for the second record. + Mode = 1 calculates the one-tailed test, Mode = 2 the two- tailed test. + Type is the kind of t-test to perform. Type 1 means paired. Type 2 means two samples, equal variance (homoscedastic). Type 3 means two samples, unequal variance (heteroscedastic). + + =T.TEST(A1:A50;B1:B50;2;2) + + + + COM.MICROSOFT.T.TEST +
+
+TDIST function + t-distribution + + +

TDIST

+ Returns the t-distribution. + + TDIST(Number; DegreesFreedom; Mode) + + Number is the value for which the t-distribution is calculated. + + DegreesFreedom is the number of degrees of freedom for the t-distribution. + + Mode = 1 returns the one-tailed test, Mode = 2 returns the two-tailed test. + + + =TDIST(12;5;1) + +
+
+ + T.DIST function + t-distribution + + +

T.DIST

+ Returns the t-distribution. + + T.DIST(Number; DegreesFreedom; Cumulative) + Number is the value for which the t-distribution is calculated. + DegreesFreedom is the number of degrees of freedom for the t-distribution. + Cumulative = 0 or FALSE returns the probability density function, 1 or TRUE returns the cumulative distribution function. + + =T.DIST(1; 10; TRUE) returns 0.8295534338 + + + + COM.MICROSOFT.T.DIST +
+
+ + T.DIST.2T function + two tailed t-distribution + + +

T.DIST.2T

+ Calculates the two-tailed Student's T Distribution, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets. + + T.DIST.2T(Number; DegreesFreedom) + Number is the value for which the t-distribution is calculated. + DegreesFreedom is the number of degrees of freedom for the t-distribution. + + =T.DIST.2T(1; 10) returns 0.3408931323. + + + + COM.MICROSOFT.T.DIST.2T +
+
+ + T.DIST.RT function + right tailed t-distribution + + +

T.DIST.RT

+ Calculates the right-tailed Student's T Distribution, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets. + + T.DIST.RT(Number; DegreesFreedom) + Number is the value for which the t-distribution is calculated. + DegreesFreedom is the number of degrees of freedom for the t-distribution. + + =T.DIST.RT(1; 10) returns 0.1704465662. + + + + COM.MICROSOFT.T.DIST.RT +
+
+VAR function + variances + + +

VAR

+ Estimates the variance based on a sample. + + + VAR() + + The parameters should specify at least two values. + + + + =VAR(A1:A50) + +
+
+ + VAR.S function + variances + + +

VAR.S

+ Estimates the variance based on a sample. + + VAR.S() + + The parameters should specify at least two values. + + =VAR.S(A1:A50) + + + + COM.MICROSOFT.VAR.S +
+
+VARA function + + +

VARA

+ Estimates a variance based on a sample. The value of text is 0. + + VARA() + + The parameters should specify at least two values. + + + =VARA(A1:A50) + +
+
+VARP function + + +

VARP

+ Calculates a variance based on the entire population. + + VARP() + + + + + =VARP(A1:A50) + +
+
+ + VAR.P function + + +

VAR.P

+ Calculates a variance based on the entire population. + + VAR.P() + + + =VAR.P(A1:A50) + + + + COM.MICROSOFT.VAR.P +
+
+VARPA function + + +

VARPA

+ Calculates the variance based on the entire population. The value of text is 0. + + VARPA() + + + + =VARPA(A1:A50) + +
+
+PERMUT function + number of permutations + + +

PERMUT

+ Returns the number of permutations for a given number of objects. + + PERMUT(Count1; Count2) + + Count1 is the total number of objects. + + Count2 is the number of objects in each permutation. + + + =PERMUT(6;3) returns 120. There are 120 different possibilities, to pick a sequence of 3 playing cards out of 6 playing cards. +
+
+PERMUTATIONA function + + +

PERMUTATIONA

+ Returns the number of permutations for a given number of objects (repetition allowed). + + PERMUTATIONA(Count1; Count2) + + Count1 is the total number of objects. + + Count2 is the number of objects in each permutation. + + How often can 2 objects be selected from a total of 11 objects? + + =PERMUTATIONA(11;2) returns 121. + + =PERMUTATIONA(6;3) returns 216. There are 216 different possibilities to put a sequence of 3 playing cards together out of six playing cards if every card is returned before the next one is drawn. +
+
+PROB function + + +

PROB

+ Returns the probability that values in a range are between two limits. If there is no End value, this function calculates the probability based on the principle that the Data values are equal to the value of Start. + + PROB(Data; Probability; Start [; End]) + + Data is the array or range of data in the sample. + + Probability is the array or range of the corresponding probabilities. + + Start is the start value of the interval whose probabilities are to be summed. + + End (optional) is the end value of the interval whose probabilities are to be summed. If this parameter is missing, the probability for the Start value is calculated. + + + =PROB(A1:A50;B1:B50;50;60) returns the probability with which a value within the range of A1:A50 is also within the limits between 50 and 60. Every value within the range of A1:A50 has a probability within the range of B1:B50. +
+
+WEIBULL function + + +

WEIBULL

+ Returns the values of the Weibull distribution. + The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale). + If C is 0, WEIBULL calculates the probability density function. + If C is 1, WEIBULL calculates the cumulative distribution function. + + WEIBULL(Number; Alpha; Beta; C) + + Number is the value at which to calculate the Weibull distribution. + + Alpha is the shape parameter of the Weibull distribution. + + Beta is the scale parameter of the Weibull distribution. + + C indicates the type of function. + + + =WEIBULL(2;1;1;1) returns 0.86. + See also the Wiki page. +
+
+ + WEIBULL.DIST function + + +

WEIBULL.DIST

+ Returns the values of the Weibull distribution. + The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale). + If C is 0, WEIBULL.DIST calculates the probability density function. + If C is 1, WEIBULL.DIST calculates the cumulative distribution function. + + WEIBULL.DIST(Number; Alpha; Beta; C) + Number is the value at which to calculate the Weibull distribution. + Alpha is the shape parameter of the Weibull distribution. + Beta is the scale parameter of the Weibull distribution. + C indicates the type of function. + + =WEIBULL.DIST(2;1;1;1) returns 0.8646647168. + + + See also the Wiki page. + + COM.MICROSOFT.WEIBULL.DIST +
+ +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04060199.xhp b/helpcontent2/source/text/scalc/01/04060199.xhp new file mode 100644 index 000000000..b30def43f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060199.xhp @@ -0,0 +1,297 @@ + + + + + +Operators in $[officename] Calc +/text/scalc/01/04060199.xhp + + + +formulas; operators +operators; formula functions +division sign, see also operators +multiplication sign, see also operators +minus sign, see also operators +plus sign, see also operators +text operators +comparisons;operators in Calc +arithmetical operators +reference operators +mw added 7 new index entries

Operators in $[officename] Calc

+You can use the following operators in $[officename] Calc: +

Arithmetical Operators

+These operators return numerical results. + + + +Operator + + +Name + + + Example + + + + ++ (Plus) + + +Addition + + +1+1 + + + + +- (Minus) + + +Subtraction + + +2-1 + + + + +- (Minus) + + +Negation + + +-5 + + + + +* (asterisk) + + +Multiplication + + +2*2 + + + + +/ (Slash) + + +Division + + +9/3 + + + + +% (Percent) + + +Percent + + +15% + + + + +^ (Caret) + + +Exponentiation + + +3^2 + + +
+ +Prefix "-" (negation) has a higher precedence than "^" (exponentiation). For example -3^2 equals 9, which is the square of a negative number. + +

Comparative operators

+These operators return either true or false. + + + +Operator + + +Name + + + Example + + + + += (equal sign) + + +Equal + + +A1=B1 + + + + +> (Greater than) + + +Greater than + + +A1>B1 + + + + +< (Less than) + + +Less than + + +A1<B1 + + + + +>= (Greater than or equal to) + + +Greater than or equal to + + +A1>=B1 + + + + +<= (Less than or equal to) + + +Less than or equal to + + +A1<=B1 + + + + +<> (Inequality) + + +Inequality + + +A1<>B1 + + +
+

Text operators

+The operator combines separate texts into one text. + + + +Operator + + +Name + + +Example + + + + +& (And) + + +text concatenation AND + +text concatenation AND + + +"Sun" & "day" is "Sunday" + + +
+

Reference operators

+These operators return a cell range of zero, one or more cells. +Range has the highest precedence, then intersection, and then finally union. + + + +Operator + + +Name + + + Example + + + + +: (Colon) + + +Range + + +A1:C108 + + + + +! (Exclamation point) + + +intersection operator + +Intersection + + +SUM(A1:B6!B5:C12) +Calculates the sum of all cells in the intersection; in this example, the result yields the sum of cells B5 and B6. + + + + +~ (Tilde) + + +Concatenation or union + + +Takes two references and returns a reference list, which is a concatenation of the left reference followed by the right reference. Double entries are referenced twice. See note below this table. + + +
+Reference concatenation using a tilde character was implemented lately. When a formula with the tilde operator exists in a document that is opened in old versions of the software, an error is returned. A reference list is not allowed inside an array expression. + + diff --git a/helpcontent2/source/text/scalc/01/04070000.xhp b/helpcontent2/source/text/scalc/01/04070000.xhp new file mode 100644 index 000000000..5aed37738 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070000.xhp @@ -0,0 +1,47 @@ + + + + + +Named Ranges and Expressions +/text/scalc/01/04070000.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Named Ranges and Expressions

+Allows you to name the different sections of your spreadsheet document. By naming the different sections, you can easily navigate through the spreadsheet documents and find specific information. +
+
+ +
+

Define

+ +

Insert

+ +

Apply

+ +

Labels

+ + + diff --git a/helpcontent2/source/text/scalc/01/04070100.xhp b/helpcontent2/source/text/scalc/01/04070100.xhp new file mode 100644 index 000000000..ca27918f7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070100.xhp @@ -0,0 +1,87 @@ + + + + + + + + +Define Names +/text/scalc/01/04070100.xhp + + + + + + + + +Define Names +Opens a dialog where you can specify a name for a selected area or a name for a formula expression. + +Use the mouse to define ranges or type the reference into the Define Name dialog fields. +
+ +
+The Sheet Area box on the Formula bar contains a list of defined names for the ranges or formula expressions and their scope between parenthesis. Click a name from this box to highlight the corresponding reference on the spreadsheet. Names given formulas or parts of a formula are not listed here. + + +Name +Enter the name of the area for which you want to define a reference or a formula expression. All area names already defined in the spreadsheet are listed in the text field above. If you click a name on the list, the corresponding reference in the document will be shown with a blue frame. If multiple cell ranges belong to the same area name, they are displayed with different colored frames. + + +Range or formula expression +The reference of the selected area name is shown here as an absolute value. +To insert a new area reference, place the cursor in this field and use your mouse to select the desired area in any sheet of your spreadsheet document. To insert a new named formula, type the formula expression. + + + +Scope +Select the scope of the named range or named formula. Document (Global) means the name is valid for the whole document. Any other sheet name selected will restrict the scope of the named range or formula expression to that sheet. + + +Range options +Allows you to specify the Area type (optional) for the reference. +Defines additional options related to the type of reference area. + + +Print range +Defines the area as a print range. + + +Filter +Defines the selected area to be used in an advanced filter. + + +Repeat column +Defines the area as a repeating column. + + +Repeat row +Defines the area as a repeating row. + + +Add +Click the Add button to add a new defined name. + + + +Select a named range or named formula from the list to modify its properties. + + diff --git a/helpcontent2/source/text/scalc/01/04070200.xhp b/helpcontent2/source/text/scalc/01/04070200.xhp new file mode 100644 index 000000000..24dafe521 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070200.xhp @@ -0,0 +1,59 @@ + + + + + + + + +Paste Names +/text/scalc/01/04070200.xhp + + +Sun Microsystems, Inc. + + + +cell ranges; inserting named ranges +inserting; cell ranges pasting; cell ranges + + + + +Paste Names +Inserts a defined named cell range at the current cursor's position. + +You can only insert a cell area after having defined a name for the area. +
+ +
+ + +Table area +Lists all defined cell areas. Double-click an entry to insert the named area into the active sheet at the current cursor position. + + +Paste All +Inserts a list of all named areas and the corresponding cell references at the current cursor position. + + +Paste +Inserts the selected named area and the corresponding cell reference at the current cursor position. + + diff --git a/helpcontent2/source/text/scalc/01/04070300.xhp b/helpcontent2/source/text/scalc/01/04070300.xhp new file mode 100644 index 000000000..f98549434 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070300.xhp @@ -0,0 +1,61 @@ + + + + + + + + +Creating Names +/text/scalc/01/04070300.xhp + + +Sun Microsystems, Inc. + + + +cell ranges;creating names automatically +names; for cell ranges + + + + +Creating Names +Allows you to automatically name multiple cell ranges. + +
+ +
+Select the area containing all the ranges that you want to name. Then choose Sheet - Named Ranges and Expressions - Create. This opens the Create Names dialog, from which you can select the naming options that you want. +Create names from +Defines which part of the spreadsheet is to be used for creating the name. + +Top row +Creates the range names from the header row of the selected range. Each column receives a separated name and cell reference. + +Left Column +Creates the range names from the entries in the first column of the selected sheet range. Each row receives a separated name and cell reference. + +Bottom row +Creates the range names from the entries in the last row of the selected sheet range. Each column receives a separated name and cell reference. + +Right Column +Creates the range names from the entries in the last column of the selected sheet range. Each row receives a separated name and cell reference. + + diff --git a/helpcontent2/source/text/scalc/01/04070400.xhp b/helpcontent2/source/text/scalc/01/04070400.xhp new file mode 100644 index 000000000..3cc0ad738 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070400.xhp @@ -0,0 +1,69 @@ + + + + + + + + +Define Label Range +/text/scalc/01/04070400.xhp + + + +sheets; defining label ranges +label ranges in sheets + + + + +Define Label Range + +Opens a dialog in which you can define a label range. + +
+ +
+ +The cell contents of a label range can be used like names in formulas - $[officename] recognizes these names in the same manner that it does the predefined names of the weekdays and months. These names are automatically completed when typed into a formula. In addition, the names defined by label ranges will have priority over names defined by automatically generated ranges. +You can set label ranges that contain the same labels on different sheets. $[officename] first searches the label ranges of the current sheet and, following a failed search, the ranges of other sheets. + + +Range +Displays the cell reference of each label range. In order to remove a label range from the list box, select it and then click Delete. + + +Contains column labels +Includes column labels in the current label range. + +Contains row labels +Includes row labels in the current label range. + +For data range +Sets the data range for which the selected label range is valid. To modify it, click in the sheet and select another range with the mouse. + + +Add +Adds the current label range to the list. + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/04080000.xhp b/helpcontent2/source/text/scalc/01/04080000.xhp new file mode 100644 index 000000000..6d9c5831f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04080000.xhp @@ -0,0 +1,71 @@ + + + + + + + Function List + /text/scalc/01/04080000.xhp + + + + + + + formula list window + function list window + inserting functions; function list window + + + + + +

Function List

+Opens the Function List deck of the Sidebar, which displays all functions that can be inserted into your document. The Function List deck is similar to the Functions tab page of the Function Wizard. The functions are inserted with placeholders to be replaced with your own values. + +
+ +
+The Function List window is a resizable dockable window. Use it to quickly enter functions in the spreadsheet. By double-clicking an entry in the functions list, the respective function is directly inserted with all parameters. + + +

Category List

+ + + +

Function List

+Displays the available functions. When you select a function, the area below the list box displays a short description. To insert the selected function double-click it or click the Insert Function into calculation sheet icon. + + +

Insert Function into calculation sheet

+ + + + + Icon Insert Function + + + Inserts the selected function into the document. + + +
+ + + + diff --git a/helpcontent2/source/text/scalc/01/04090000.xhp b/helpcontent2/source/text/scalc/01/04090000.xhp new file mode 100644 index 000000000..e78f7a721 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04090000.xhp @@ -0,0 +1,58 @@ + + + + + + + + + External Links + /text/scalc/01/04090000.xhp + + + +
+ + +Open a file dialog to locate the file containing the data you want to insert. + + + +External Links + Inserts data from an HTML, Calc, CSV or Excel file into the current sheet as a link. The data must be located within a named range. +
+
+ +
+ +URL of external data source. +Enter the URL or the file name that contains the data that you want to insert, and then press Enter. Alternatively, click Browse button to select the file name from a file dialog that opens. Only then will the URL be requested from the network or file system. +A dialog for CSV data import appears when linking to external CSV file. + +Available tables/ranges + Select the table or the data range that you want to insert. If the selected Calc or Excel document contains no named range, spreadsheet data cannot be inserted and OK button will remain inactive + + +Update every + Enter the number of seconds to wait before the external data are reloaded into the current document. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/05020000.xhp b/helpcontent2/source/text/scalc/01/05020000.xhp new file mode 100644 index 000000000..ed2b49968 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05020000.xhp @@ -0,0 +1,57 @@ + + + + + +Format Cells +/text/scalc/01/05020000.xhp + + +Sun Microsystems, Inc. + + + +cell attributes +attributes;cells +formatting;cells +cells;formatting dialog + + +

Format Cells

+Allows you to specify a variety of formatting options and to apply attributes to the selected cells. + +
+ +
+ + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/01/05020600.xhp b/helpcontent2/source/text/scalc/01/05020600.xhp new file mode 100644 index 000000000..011b07e9c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05020600.xhp @@ -0,0 +1,59 @@ + + + + + + + + +Cell Protection +/text/scalc/01/05020600.xhp + + +Sun Microsystems, Inc. + + + +
+ + +Cell Protection +Defines protection options for selected cells. +
+
+ +
+Protection + +Hide all +Hides formulas and contents of the selected cells. + +Protected +Prevents the selected cells from being modified. +This cell protection only takes effect if you also protect the sheet (Tools - Protect Sheet). + +Hide formula +Hides formulas in the selected cells. +Print +Defines print options for the sheet. + +Hide when printing +Keeps the selected cells from being printed. + + diff --git a/helpcontent2/source/text/scalc/01/05030000.xhp b/helpcontent2/source/text/scalc/01/05030000.xhp new file mode 100644 index 000000000..4fa978e17 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030000.xhp @@ -0,0 +1,48 @@ + + + + + + + + +Row +/text/scalc/01/05030000.xhp + + +Sun Microsystems, Inc. + + + +
+ +Row +Sets the row height and hides or shows selected rows. +
+
+ +
+Height + +Optimal Height + + + + + diff --git a/helpcontent2/source/text/scalc/01/05030200.xhp b/helpcontent2/source/text/scalc/01/05030200.xhp new file mode 100644 index 000000000..dbca42674 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030200.xhp @@ -0,0 +1,53 @@ + + + + + + + + +Optimal Row Heights +/text/scalc/01/05030200.xhp + + +Sun Microsystems, Inc. + + + +sheets; optimal row heights +rows; optimal heights +optimal row heights + + + + +Optimal Row Heights +Determines the optimal row height for the selected rows. + The optimal row height depends on the font size of the largest character in the row. You can use various units of measure. +
+ +
+ +Add +Sets additional spacing between the largest character in a row and the cell boundaries. + +Default value +Restores the default value for the optimal row height. + + diff --git a/helpcontent2/source/text/scalc/01/05030300.xhp b/helpcontent2/source/text/scalc/01/05030300.xhp new file mode 100644 index 000000000..bf465e4ab --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030300.xhp @@ -0,0 +1,64 @@ + + + + + + + + +Hide +/text/scalc/01/05030300.xhp + + +Sun Microsystems, Inc. + + + +
+spreadsheets; hiding functions +hiding; rows +hiding; columns +hiding; sheets +sheets;hiding +columns;hiding +rows;hiding + + + + +Hide +Hides selected rows, columns or individual sheets. +
+
+ +
+Select the rows or columns that you want to hide, and then choose Format - Rows - Hide or Format - Columns - Hide. +You can hide a sheet by selecting the sheet tab and then choosing Format - Sheet - Hide. Hidden sheets are not printed unless they occur within a print range. +A break in the row or column header indicates whether the row or column is hidden. +To display hidden rows, columns or sheets + + +Select the range that includes the hidden objects. You can also use the box in the corner above row 1 and beside column A. For sheets, this step is not necessary.UFI: fixes #i18582# + + +Choose Format - Rows/Columns - Show or Format - Sheet - Show. + + + + diff --git a/helpcontent2/source/text/scalc/01/05030400.xhp b/helpcontent2/source/text/scalc/01/05030400.xhp new file mode 100644 index 000000000..02d47ef6b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030400.xhp @@ -0,0 +1,50 @@ + + + + + + + + +Show +/text/scalc/01/05030400.xhp + + +Sun Microsystems, Inc. + + + +
+spreadsheets; showing columns +showing; columns +showing; rows + + + +Show +Choose this command to show previously hidden rows or columns. +
+
+ +
+To show a column or row, select the range of rows or columns containing the hidden elements, then choose Format - Rows - Show or Format - Columns - Show. +For example, to show the column B, click on the header of the column A, expand the selection to the column C, then chose Format - Columns - Show. To show the column A previously hidden, click on the header of the column B, keep the mouse button pressed and drag on the left. The selected range displayed in the name area changes from B1:B1048576 to A1:B1048576. Choose Format - Columns - Show. Proceed the same way with rows. +To show all hidden cells, first click in the field in the upper left corner. This selects all cells of the table. + + diff --git a/helpcontent2/source/text/scalc/01/05040000.xhp b/helpcontent2/source/text/scalc/01/05040000.xhp new file mode 100644 index 000000000..ee3e1a861 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05040000.xhp @@ -0,0 +1,48 @@ + + + + + + + + +Column +/text/scalc/01/05040000.xhp + + +Sun Microsystems, Inc. + + + +
+ +Column +Sets the column width and hides or shows selected columns. +
+
+ +
+Width + +Optimal Width + + + + + diff --git a/helpcontent2/source/text/scalc/01/05040200.xhp b/helpcontent2/source/text/scalc/01/05040200.xhp new file mode 100644 index 000000000..980f26279 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05040200.xhp @@ -0,0 +1,54 @@ + + + + + + + + +Optimal Column Width +/text/scalc/01/05040200.xhp + + +Sun Microsystems, Inc. + + + +spreadsheets; optimal column widths +columns; optimal widths +optimal column widths + + + + + +Optimal Column Width +Defines the optimal column width for selected columns. + The optimal column width depends on the longest entry within a column. You can choose from the available measurement units. +
+ +
+ +Add +Defines additional spacing between the longest entry in a column and the vertical column borders. + +Default value +Defines the optimal column width in order to display the entire contents of the column. The additional spacing for the optimal column width is preset to 2 mm. + + diff --git a/helpcontent2/source/text/scalc/01/05050000.xhp b/helpcontent2/source/text/scalc/01/05050000.xhp new file mode 100644 index 000000000..664ff6426 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05050000.xhp @@ -0,0 +1,55 @@ + + + + + + + + +Sheet +/text/scalc/01/05050000.xhp + + +Sun Microsystems, Inc. + + + +
+CTL;right-to-left sheets +sheets;right-to-left +right-to-left text;spreadsheets +mw changed "right-to-left;..." + +Sheet +Sets the sheet name and hides or shows selected sheets. +
+
+ +
+Rename + + +Show + +If a sheet has been hidden, the Show Sheet dialog opens, which allows you to select a sheet to be shown again. + +Right-To-Left +Changes the orientation of the current sheet to Right-To-Left if CTL support is enabled. + + diff --git a/helpcontent2/source/text/scalc/01/05050100.xhp b/helpcontent2/source/text/scalc/01/05050100.xhp new file mode 100644 index 000000000..525d60862 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05050100.xhp @@ -0,0 +1,56 @@ + + + + + + + + +Rename Sheet +/text/scalc/01/05050100.xhp + + + +worksheet names +changing; sheet names +sheets; renaming + + + + + +Rename Sheet +This command opens a dialog where you can assign a different name to the current sheet. + +
+ +
+ + + +Name +Enter a new name for the sheet here. +You can also open the Rename Sheet dialog through the context menu by positioning the mouse pointer over a sheet tab at the bottom of the window and clicking while pressing Controlclicking the right mouse button. +Alternatively, click the sheet tab while pressing the CommandAlt key. Now you can change the name directly. + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/05050300.xhp b/helpcontent2/source/text/scalc/01/05050300.xhp new file mode 100644 index 000000000..f0628b62b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05050300.xhp @@ -0,0 +1,47 @@ + + + + + + + + +Show Sheet +/text/scalc/01/05050300.xhp + + +Sun Microsystems, Inc. + + + + + + sheets; displayingdisplaying; sheets + +Show Sheet + Displays sheets that were previously hidden with the Hide Sheets command. Select one sheet only to call the command. The current sheet is always selected. If a sheet other than the current sheet is selected, you can deselect it by pressing Command Ctrl while clicking the corresponding sheet tab at the bottom of the window. +
+ +
+ + + Hidden sheets + Displays a list of all hidden sheets in your spreadsheet document. To show a certain sheet, click the corresponding entry on the list and confirm with OK. + + diff --git a/helpcontent2/source/text/scalc/01/05060000.xhp b/helpcontent2/source/text/scalc/01/05060000.xhp new file mode 100644 index 000000000..b01c72240 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05060000.xhp @@ -0,0 +1,88 @@ + + + + + +Merge and Center Cells +/text/scalc/01/05060000.xhp + + +Sun Microsystems, Inc. + + + + + toggle merge and center cells + + + + +

Merge and Center Cells

+This is a toggleable control that joins all cells in a rectangular selection into a single cell, or returns merged cells to the original individual cells. When merging it will format the merged cell as center aligned. +The control is shown toggled-on whenever there are merged cells in the selection, indicating that clicking the control will unmerge those cells. +
+Merging cells can lead to calculation errors in formulas in the table. +
+
+Do one of the following: +In the Formatting toolbar, click: + + + + +Icon Merge and Center Cells + + +Merge and Center Cells + + +
+Or, choose Format - Merge and Unmerge Cells - Merge and Center Cells. +
+
+Cells cannot be merged again without first unmerging them. +Merging a cell selection that partially includes merged cells is generally possible with Unmerge Cells followed by Merge Cells, without altering the initial selection. The result will be largely depend on previous choices when merging cells made with the Merge Cells Dialog options described below. +Multiple selection is not supported, that is, the selection must be rectangular. +The merged cell receives the name and content of the first cell of the selection. +If more than one cell to be merged has content the Merge Cells dialog opens. + + + +

Merge Cells Dialog Options

+Three options are available: + + + Move the contents of the hidden cells into the first cell: The actual contents of the hidden cells are concatenated to the first cell, and hidden cells are emptied; the results of formulas referring to the hidden cells or the first cell will be updated. + + + Keep the contents of the hidden cells: The contents of the hidden cells are kept; the results of formulas referring to the hidden cells will not change. + + + Empty the contents of the hidden cells: The contents of the hidden cells are removed; the results of formulas referring to the hidden cells will be updated. + + +
+
+ + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/05070000.xhp b/helpcontent2/source/text/scalc/01/05070000.xhp new file mode 100644 index 000000000..d4d81913a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05070000.xhp @@ -0,0 +1,53 @@ + + + + + +Page Style +/text/scalc/01/05070000.xhp + + +Sun Microsystems, Inc. + + + + +style;page +page;style +format;page +formatting;page + + +
+

Page Style

+Opens a dialog where you can define the appearance of all pages in your document. +
+
+ +
+ + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/01/05070500.xhp b/helpcontent2/source/text/scalc/01/05070500.xhp new file mode 100644 index 000000000..9ef68735e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05070500.xhp @@ -0,0 +1,100 @@ + + + + + + + + + + +Sheet +/text/scalc/01/05070500.xhp + + + +
+ + +pages; order when printing +printing; page order +mw deletes three "printing;..." entries and copies 4 index entries to Calc guide print_details.xhpSheet +Specifies the elements to be included in the printout of all sheets with the current Page Style. Additionally, you can set the print order, the first page number, and the page scale. +
+
+ +
+Print +Defines which elements of the spreadsheet are to be printed. +Column and row headers +Specifies whether you want the column and row headers to be printed. +Grid +Prints out the borders of the individual cells as a grid. For the view on screen, make your choice under %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View - Grid lines. +Comments +Prints the comments defined in your spreadsheet. They will be printed on a separate page, along with the corresponding cell reference. +Objects/images +Includes all inserted objects (if printable) and graphics with the printed document. +Charts +Prints the charts that have been inserted into your spreadsheet. +Drawing Objects +Includes all drawing objects in the printed document. +Formulas +Prints the formulas contained in the cells, instead of the results. +Zero Values +Specifies that cells with a zero value are printed. +Page Order +Defines the order in which data in a sheet is numbered and printed when it does not fit on one printed page. +Top to bottom, then right +Prints vertically from the left column to the bottom of the sheet. +Left to right, then down +Prints horizontally from the top row of the sheet to the right column. +First page number +Select this option if you want this style to restart page numbering. +Enter the number you want to restart at. +Scale +Defines a page scale for the printed spreadsheet. +Scaling mode +Select a scaling mode from the list box. Appropriate controls will be shown below the list box. +Reduce/enlarge printout +Specifies a scaling factor to scale all printed pages. +Scaling factor +Enter a scaling factor. Factors less than 100 reduce the pages, higher factors enlarge the pages. +Fit print range(s) to width/height +Specifies the maximum number of pages horizontally (width) and vertically (height) on which every sheet with the current Page Style is to be printed. + + +The print ranges are always scaled proportionally, so the resulting number of pages may be less than specified. + + +You may disable one of the boxes, then the unspecified dimension will use as many pages as necessary. + + +If you disable both boxes, this will result in a scaling factor of 100%. + + +Width in pages +Enter the maximum number of pages to be printed horizontally across. +Height in pages +Enter the maximum number of pages to be printed vertically stacked. +Fit print range(s) on number of pages +Specifies the maximum number of pages on which every sheet with the current Page Style is to be printed. The scale will be reduced as necessary to fit the defined number of pages.UFI: fixes #112585# +Number of pages +Enter the maximum number of pages to be printed. + + diff --git a/helpcontent2/source/text/scalc/01/05080000.xhp b/helpcontent2/source/text/scalc/01/05080000.xhp new file mode 100644 index 000000000..9ee25b7ab --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080000.xhp @@ -0,0 +1,48 @@ + + + + + + + + +Print Ranges +/text/scalc/01/05080000.xhp + + +Sun Microsystems, Inc. + + + + +
+Print Ranges +Manages print ranges. Only cells within the print ranges will be printed. +
+
+ +
+If you do not define any print range manually, Calc assigns an automatic print range to include all the cells that are not empty. + + + +Edit + + + diff --git a/helpcontent2/source/text/scalc/01/05080100.xhp b/helpcontent2/source/text/scalc/01/05080100.xhp new file mode 100644 index 000000000..d7645a6c5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080100.xhp @@ -0,0 +1,42 @@ + + + + + + + + +Define +/text/scalc/01/05080100.xhp + + +Sun Microsystems, Inc. + + + +
+ +Define +Defines an active cell or selected cell area as the print range. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/05080200.xhp b/helpcontent2/source/text/scalc/01/05080200.xhp new file mode 100644 index 000000000..cfd348d95 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080200.xhp @@ -0,0 +1,42 @@ + + + + + + + + +Clear +/text/scalc/01/05080200.xhp + + +Sun Microsystems, Inc. + + + +
+ +Clear +Removes the defined print area. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/05080300.xhp b/helpcontent2/source/text/scalc/01/05080300.xhp new file mode 100644 index 000000000..73e4084c4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080300.xhp @@ -0,0 +1,63 @@ + + + + + + + + +Edit Print Ranges +/text/scalc/01/05080300.xhp + + + + + + +Edit Print Ranges +Opens a dialog where you can specify the print range. + You can also set the rows or columns which are to be repeated in every page. +
+ +
+ + + + + + +Print range +Allows you to modify a defined print range. +Select -none- to remove a print range definition for the current spreadsheet. Select -entire sheet- to set the current sheet as a print range. Select -selection- to define the selected area of a spreadsheet as the print range. By selecting -user-defined-, you can define a print range that you have already defined using the Format - Print Ranges - Define command. If you have given a name to a range using the Sheet - Named Ranges and Expressions - Define command, this name will be displayed and can be selected from the list box. +In the right-hand text box, you can enter a print range by reference or by name. If the cursor is in the Print range text box, you can also select the print range in the spreadsheet with your mouse. + + + +Rows to repeat +Choose one or more rows to print on every page. In the right text box enter the row reference, for example, "1" or "$1" or "$2:$3". The list box displays -user defined-. You can also select -none- to remove a defined repeating row. +You can also define repeating rows by dragging the mouse in the spreadsheet, if the cursor is in the Rows to repeat text field in the dialog. + + + +Columns to repeat +Choose one or more columns to print on every page. In the right text box enter the column reference, for example, "A" or "AB" or "$C:$E". The list box then displays -user defined-. You can also select -none- to remove a defined repeating column. +You can also define repeating columns by dragging the mouse in the spreadsheet, if the cursor is in the Columns to repeat text field in the dialog. + + + diff --git a/helpcontent2/source/text/scalc/01/05080400.xhp b/helpcontent2/source/text/scalc/01/05080400.xhp new file mode 100644 index 000000000..0068cf860 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080400.xhp @@ -0,0 +1,42 @@ + + + + + + + + +Add +/text/scalc/01/05080400.xhp + + +Sun Microsystems, Inc. + + + +
+ +Add +Adds the current selection to the defined print areas. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/05100000.xhp b/helpcontent2/source/text/scalc/01/05100000.xhp new file mode 100644 index 000000000..c99bafcbe --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05100000.xhp @@ -0,0 +1,165 @@ + + + + + + + Styles in Calc + /text/scalc/01/05100000.xhp + + + + + +
+ +Stylist, see Styles window +Styles window +formats; Styles window +formatting; Styles window +paint can for applying styles +styles in spreadsheets +styles; in Calc + + +

Styles

+Use the Styles deck of the Sidebar to assign styles to cells and pages. You can apply, update, and modify existing styles or create new styles. +
+The Styles dockable window can remain open while editing the document. + +
+ +
+ +

How to apply a cell style:

+ + + + Select the cell or cell range. + + + Double-click the style in the Styles window. + + + + +Displays the list of the available Cell Styles. + + + + Icon Cell Styles + + + Cell Styles + + +
+ + + +

Page Styles

+Displays the Page Styles available. + + + + + Icon Page Styles + + + Page Styles + + +
+ + + +

Fill Format Mode

+Turns the Fill Format mode on and off. Use the paint can to assign the Style selected in the Styles window. + + + + + Icon Fill Format Mode + + + Fill Format Mode + + +
+ +

How to apply a new style with the paint can:

+ + + + Select the desired style from the Styles window. + + + Click the Fill Format Mode icon. + + + Click a cell to format it, or drag your mouse over a certain range to format the whole range. Repeat this action for other cells and ranges. + + + Click the Fill Format Mode icon again to exit this mode. + + + + +

New Style from Selection

+Creates a new style based on the formatting of a selected object. Assign a name for the style in the Create Style dialog. + + + + + Icon New Style from Selection + + + New Style from Selection + + +
+ + + +

Update Style

+Updates the Style selected in the Styles window with the current formatting of the selected object. + + + + + Icon Update Style + + + Update Style + + +
+ + + +

Style List

+Displays the list of the styles from the selected style category. +In the context menu you can choose commands to create a new style, delete a user-defined style, or change the selected style. + + +

Style GroupsUFI: use "groups" to be consistent with Writer

+Lists the available style groups. + + + diff --git a/helpcontent2/source/text/scalc/01/05110000.xhp b/helpcontent2/source/text/scalc/01/05110000.xhp new file mode 100644 index 000000000..2fe12c538 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05110000.xhp @@ -0,0 +1,78 @@ + + + + + + + AutoFormat + /text/scalc/01/05110000.xhp + + + + + + + +

AutoFormat

+ Use this command to apply an AutoFormat to a selected sheet area or to define your own AutoFormats. +
+ +
+ The AutoFormat command is available only if a cell range with at least 3 columns and 3 rows are selected. Otherwise this command will appear grayed out in the menu. + +Format +Choose a predefined AutoFormat to apply to a selected area in your sheet. + + +Add +Allows you to add the current formatting of a range of at least 4 x 4 cells to the list of predefined AutoFormats. The Add AutoFormat dialog then appears. + +Enter a name and click OK. + + +Rename +Opens a dialog where you can change the name of the selected AutoFormat. + +The Rename AutoFormat dialog opens. Enter the new name of the AutoFormat here. + +Formatting +In this section you can select or deselect the available formatting options. If you want to keep any of the settings currently in your spreadsheet, deselect the corresponding option. + +Number format +When marked, specifies that you want to retain the number format of the selected format. + +Borders +When marked, specifies that you want to retain the border of the selected format. + +Font +When marked, specifies that you want to retain the font of the selected format. + +Pattern +When marked, specifies that you want to retain the pattern of the selected format. + +Alignment +When marked, specifies that you want to retain the alignment of the selected format. + +AutoFit width and height +When marked, specifies that you want to retain the width and height of the selected cells of the selected format. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/05120000.xhp b/helpcontent2/source/text/scalc/01/05120000.xhp new file mode 100644 index 000000000..9abe1ee3e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05120000.xhp @@ -0,0 +1,183 @@ + + + + + + + + + Conditional Formatting + /text/scalc/01/05120000.xhp + + + + + + + +

Conditional Formatting

+ Use Conditional Formatting to define range-based conditions that determine which cell style will be applied to each cell in a given range based on its contents. The cell style corresponding to the first condition that evaluates to true is applied. Cell styles applied through Conditional Formatting override cell styles applied manually using the Formatting Bar or the Styles sidebar. +
+ +
+ You can enter several conditions that query the cell values or results of formulas. The conditions are evaluated from first to the last. If Condition 1 is true based on the current cell contents, the corresponding cell style is applied. Otherwise, Condition 2 is evaluated to determine if its corresponding style will be applied. If none of the conditions match cell contents, then no changes are made to the cell format. + Conditional formats do no overwrite cell styles and direct formatting applied manually. They remain saved as cell properties and are applied when the cell matches no conditions or when you remove all conditional formats. + To apply conditional formatting, AutoCalculate must be enabled. Choose Data - Calculate - AutoCalculate (you see a check mark next to the command when AutoCalculate is enabled). +conditional formatting; conditions + + +

Condition list

+ List of the conditions defined for the cell range in order of evaluation. You can define as many conditions as you want. + +

Up

+Increase priority of the selected condition. +

Down

+ + Decrease priority of the selected condition. + +

Condition list entry

+ Specify if conditional formatting is dependent on one of the entry listed on the drop down box: + + + + + + If you select All cells, see Color Scale, Data Bar or Icon Set explanations below, depending on which visual representation the conditional formatting should be represented. + + + If you select Cell value is: + FIXME: Hack to get a nested list + + + Select a condition in the drop down list for the format to be applied to the selected cells and enter the value. + + + In front of Apply Styles, select the desired style in the list or chose New Style to create one. + + + Click the Add button to add another condition, click the Remove button to remove a condition. + + + In the Range field, define the range of cells concerned by the conditional formatting. Click on the Shrink button to minimize the dialog box. Click again on the button to come back to the dialog box once the range is selected. + + + + + + If you select Formula is as a reference, enter a cell reference. If the cell reference is a value other than zero, the condition matches. + + + If you select Date is, see below explanations for Date. + + + +

Color Scale

+ This is the same dialog box as if you select All cells in the first sub menu entry Condition. +Apply a color scale to a range consist of displaying a bicolor or tricolor gradient on this range depending on the value of each cell. A typical example might be an array of temperatures, lower blue colored, warmer red with a gradient nuances to the intermediate values. + You must choose the two "extreme" colors indicate the method of calculation. The calculation of the color applied will be made in relation to: Min - Max - Percentile - Value - Percent - Formula. + The choices Min and Max are sufficient to themselves as found in the range. Other options need to be specified by a value (Percentile, Value, Percentage) or a cell reference or formula (Formula). + For a detailed explanation and examples, please visit How to apply a Color Scale Conditional Formatting page in TDF Wiki. + +

Data Bar

+ Data bar option will fill the cell with solid or gradient color corresponding to the numeric value in the cell. Default is blue for positive and red for negative. + The calculation of the area of fill is based on Min - Max - Percentile - Value - Percent - Formula. + The choices Min and Max are sufficient to themselves as found in the range. Other options need to be specified by a value (Percentile, Value, Percentage) or a cell reference or formula (Formula). + More Options... opens a dialog to: + + + change colors + + + change position of vertical axis within the cell + + + the bar's minimum and maximum length in percentage + + + +

Icon Set

+ It is desired to plot the position of a value relative to the thresholds. The set of icons will help to indicate the thresholds and choose the type of icons. Available icon sets are: + + + 3, 4 or 5 - arrows + + + 3, 4 or 5 - gray arrows + + + 3 - flags + + + 3 - traffic lights 1 and 2 (two different designs) + + + 3 - symbols (square, triangle, circle) + + + 4 - circles from red to black + + + 4 or 5 - ratings + + + 5 - quarters + + + Conditions to display each icon can be specified relative to a value (Value), a percentage of the number of values in the range (Percentage) as a percentage of range values (Percentile) or formula (Formula). + For a detailed explanation and examples, please visit How to use Icon Set Conditional Formatting page in TDF Wiki. + +

Dates

+ This option will apply a defined style depending on a date that you choose in the drop down box: Today - Yesterday - Tomorrow - Last 7 days - This week - Last week. + + + In front of Apply Styles, select the desired style in the list or chose New Style to create one. + + + Click the Add button to add another condition, click the Remove button to remove a condition. + + + In the Range field, define the range of cells concerned by the conditional formatting. Click on the Shrink button to minimize the dialog box. Click again on the button to come back to the dialog box once the range is selected. + + + + + +

Manage Conditional Formatting

+This dialog allows you to see all the conditional formatting defined in the spreadsheet. + +
+ Choose Format - Conditional Formatting - Manage. +
+ + + +The Manage Conditional Formatting dialog box opens. Here you can add, edit or remove one or several conditional formattings. + + +The Conditional Formats list displays the active conditional formatting rules set in the current spreadsheet. Only the first rule for each cell range is listed, even if there are multiple rules defined for a given range. + +If you have defined a conditional formatting on a cell range and you try now to define a new conditional formatting on a part of this range, a warning message will be displayed, asking if you want to edit the existing conditional formatting (on the whole range) or define a new conditional formatting overlapping it (on the selected range). + +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/06020000.xhp b/helpcontent2/source/text/scalc/01/06020000.xhp new file mode 100644 index 000000000..f63951511 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06020000.xhp @@ -0,0 +1,71 @@ + + + + + + + + + +Hyphenation +/text/scalc/01/06020000.xhp + + + +automatic hyphenation in spreadsheets +hyphenation; in spreadsheets +syllables in spreadsheets +mw made "hyphenation..." a two level entry + +Hyphenation +The Hyphenation command calls the dialog for setting the hyphenation in $[officename] Calc. + +
+ +
+You can only turn on the automatic hyphenation in $[officename] Calc when the row break feature is active. +Hyphenation for selected cells. + + +Select the cells for which you want to change the hyphenation. + + +Choose Tools - Language - Hyphenation. + + +The Format Cells dialog appears with the Alignment tab page open. + + +Mark the Wrap text automatically and Hyphenation active check boxes. + + +Hyphenation for Drawing Objects + + +Select a drawing object. + + +Choose Tools - Language - Hyphenation. + + +Each time you call the command you turn the hyphenation for the drawing object on or off. A check mark shows the current status. + + + + diff --git a/helpcontent2/source/text/scalc/01/06030000.xhp b/helpcontent2/source/text/scalc/01/06030000.xhp new file mode 100644 index 000000000..c34d8ad4b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030000.xhp @@ -0,0 +1,55 @@ + + + + + + + + + Detective + /text/scalc/01/06030000.xhp + + + +
+cell links search + searching; links in cells + traces;precedents and dependents + Formula Auditing,see Detective + Detective +MW added "Detective" and a cross-reference +Detective + This command activates the Spreadsheet Detective. With the Detective, you can trace the dependencies from the current formula cell to the cells in the spreadsheet. +
+
+ +
+ Once you have defined a trace, you can point with the mouse cursor to the trace. The mouse cursor will change its shape. Double-click the trace with this cursor to select the referenced cell at the end of the trace. If you define an icon in the spreadsheet, you can put your cursor on it. It will change into a magnifying glass with reference arrows. Double-click the visible icon to select the cell at the furthest end of the icon. + + + + + + + + + + + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/06030100.xhp b/helpcontent2/source/text/scalc/01/06030100.xhp new file mode 100644 index 000000000..a301cb6c4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030100.xhp @@ -0,0 +1,47 @@ + + + + + + + + +Trace Precedents +/text/scalc/01/06030100.xhp + + +Sun Microsystems, Inc. + + + +
+cells; tracing precedents +formula cells;tracing precedents + + +Trace Precedents +This function shows the relationship between the current cell containing a formula and the cells used in the formula. +
+Traces are displayed in the sheet with marking arrows. At the same time, the range of all the cells contained in the formula of the current cell is highlighted with a blue frame. +
+ +
+This function is based on a principle of layers. For example, if the precedent cell to a formula is already indicated with a tracer arrow, when you repeat this command, the tracer arrows are drawn to the precedent cells of this cell. + + diff --git a/helpcontent2/source/text/scalc/01/06030200.xhp b/helpcontent2/source/text/scalc/01/06030200.xhp new file mode 100644 index 000000000..a11ac9c2a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030200.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Remove Precedents +/text/scalc/01/06030200.xhp + + +Sun Microsystems, Inc. + + + +
+cells; removing precedents +formula cells;removing precedents +mw changed "formula..." entry + +Remove Precedents +Deletes one level of the trace arrows that were inserted with the Trace Precedents command. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/06030300.xhp b/helpcontent2/source/text/scalc/01/06030300.xhp new file mode 100644 index 000000000..3c26b4597 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030300.xhp @@ -0,0 +1,47 @@ + + + + + + + +Trace Dependents +/text/scalc/01/06030300.xhp + + +Sun Microsystems, Inc. + + + + + +
+ cells; tracing dependents + +Trace Dependents + Draws tracer arrows to the active cell from formulas that depend on values in the active cell. +
+ The area of all cells that are used together with the active cell in a formula is highlighted by a blue frame. +
+ +
+ This function works per level. For instance, if one level of traces has already been activated to show the precedents (or dependents), then you would see the next dependency level by activating the Trace function again. + + + diff --git a/helpcontent2/source/text/scalc/01/06030400.xhp b/helpcontent2/source/text/scalc/01/06030400.xhp new file mode 100644 index 000000000..345c24430 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030400.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Remove Dependents +/text/scalc/01/06030400.xhp + + +Sun Microsystems, Inc. + + + + + +
+ cells; removing dependents + +Remove Dependents + Deletes one level of tracer arrows created with Trace Dependents. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/06030500.xhp b/helpcontent2/source/text/scalc/01/06030500.xhp new file mode 100644 index 000000000..8bb1bf550 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030500.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Remove All Traces +/text/scalc/01/06030500.xhp + + +Sun Microsystems, Inc. + + + + + +
+ cells; removing traces + +Remove All Traces + Removes all tracer arrows from the spreadsheet. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/06030600.xhp b/helpcontent2/source/text/scalc/01/06030600.xhp new file mode 100644 index 000000000..7b112100d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030600.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Trace Error +/text/scalc/01/06030600.xhp + + +Sun Microsystems, Inc. + + + + + +
+ cells; tracing errorstracing errorserror tracing + +Trace Error + Draws tracer arrows to all precedent cells which cause an error value in a selected cell. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/06030700.xhp b/helpcontent2/source/text/scalc/01/06030700.xhp new file mode 100644 index 000000000..1036bb500 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030700.xhp @@ -0,0 +1,46 @@ + + + + + + + + +Fill Mode +/text/scalc/01/06030700.xhp + + +Sun Microsystems, Inc. + + + +
+cells; trace fill mode +traces; precedents for multiple cells + + +Fill Mode +Activates the Fill Mode in the Detective. The mouse pointer changes to a special symbol, and you can click any cell to see a trace to the precedent cell. To exit this mode, press Escape or click the End Fill Mode command in the context menu. +
+
+ +
+The Fill Mode function is identical to the Trace Precedent command if you call this mode for the first time. Use the context menu to select further options for the Fill Mode and to exit this mode. + + diff --git a/helpcontent2/source/text/scalc/01/06030800.xhp b/helpcontent2/source/text/scalc/01/06030800.xhp new file mode 100644 index 000000000..4f9905b92 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030800.xhp @@ -0,0 +1,46 @@ + + + + + + + + +Mark Invalid Data +/text/scalc/01/06030800.xhp + + +Sun Microsystems, Inc. + + + + + +
+ cells; invalid datadata; showing invalid datainvalid data;marking + +Mark Invalid Data + Marks all cells in the sheet that contain values outside the validation rules. +
+
+ +
+ The validity rules restrict the input of numbers, dates, time values and text to certain values. However, it is possible to enter invalid values or copy invalid values into the cells if the Stop option is not selected. When you assign a validity rule, existing values in a cell will not be modified. + + diff --git a/helpcontent2/source/text/scalc/01/06030900.xhp b/helpcontent2/source/text/scalc/01/06030900.xhp new file mode 100644 index 000000000..495c0abff --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030900.xhp @@ -0,0 +1,58 @@ + + + + + + + + +Refresh Traces +/text/scalc/01/06030900.xhp + + +Sun Microsystems, Inc. + + + +
+cells; refreshing traces +traces; refreshing +updating;traces +mw made "updating..." a two level entry + +Refresh Traces +Redraws all traces in the sheet. Formulas modified when traces are redrawn are taken into account. +
+
+ +
+
+Detective arrows in the document are updated under the following circumstances: + + +Starting Tools - Detective - Update Refresh Traces + + + +If Tools - Detective - AutoRefresh is turned on, every time formulas are changed in the document. + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/06031000.xhp b/helpcontent2/source/text/scalc/01/06031000.xhp new file mode 100644 index 000000000..30bd550ad --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06031000.xhp @@ -0,0 +1,46 @@ + + + + + + + + +AutoRefresh +/text/scalc/01/06031000.xhp + + +Sun Microsystems, Inc. + + + + + +
+ cells; autorefreshing tracestraces; autorefreshing + +AutoRefresh + Automatically refreshes all the traces in the sheet whenever you modify a formula. +
+
+ +
+ + + diff --git a/helpcontent2/source/text/scalc/01/06040000.xhp b/helpcontent2/source/text/scalc/01/06040000.xhp new file mode 100644 index 000000000..9d773a5ac --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06040000.xhp @@ -0,0 +1,52 @@ + + + + + + + + +Goal Seek +/text/scalc/01/06040000.xhp + + + + + + +Goal Seek +Opens a dialog where you can solve an equation with a variable. + After a successful search, a dialog with the results opens, allowing you to apply the result and the target value directly to the cell. +
+ +
+Default +In this section, you can define the variables in your formula. + +Formula cell +In the formula cell, enter the reference of the cell which contains the formula. It contains the current cell reference. Click another cell in the sheet to apply its reference to the text box. + +Target value +Specifies the value you want to achieve as a new result. + +Variable cell +Specifies the reference for the cell that contains the value you want to adjust in order to reach the target. + + + diff --git a/helpcontent2/source/text/scalc/01/06050000.xhp b/helpcontent2/source/text/scalc/01/06050000.xhp new file mode 100644 index 000000000..fd5b9366f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06050000.xhp @@ -0,0 +1,80 @@ + + + + + + + + +Create Scenario +/text/scalc/01/06050000.xhp + + +Sun Microsystems, Inc. + + + + + + +Create Scenario +Defines a scenario for the selected sheet area. + +
+ +
+ + + + + +Name of scenario +Defines the name for the scenario. Use a clear and unique name so you can easily identify the scenario. You can also modify a scenario name in the Navigator through the Properties context menu command. + + +Comment +Specifies additional information about the scenario. This information will be displayed in the Navigator when you click the Scenarios icon and select the desired scenario. You can also modify this information in the Navigator through the Properties context menu command. +Settings +This section is used to define some of the settings used in the scenario display. + + +Display borderUFI: #i38688# +Highlights the scenario in your table with a border. The color for the border is specified in the field to the right of this option. The border will have a title bar displaying the name of the last scenario. The button on the right of the scenario border offers you an overview of all the scenarios in this area, if several have been defined. You can choose any of the scenarios from this list without restrictions. + +Copy back +Copies the values of cells that you change into the active scenario. If you do not select this option, the scenario is not changed when you change cell values. The behavior of the Copy back setting depends on the cell protection, the sheet protection, and the Prevent changes settings. + +Copy entire sheet +Copies the entire sheet into an additional scenario sheet. + +Prevent changes +Prevents changes to the active scenario. The behavior of the Copy back setting depends on the cell protection, the sheet protection, and the Prevent changes settings. + + +You can only change the scenario properties if the Prevent changes option is not selected and if the sheet is not protected. + + +You can only edit cell values if the Prevent changes option is selected, if the Copy back is option is not selected, and if the cells are not protected. + + +You can only change scenario cell values and write them back into the scenario if the Prevent changes option is not selected, if the Copy back option is selected, and if the cells are not protected. + + + + diff --git a/helpcontent2/source/text/scalc/01/06060000.xhp b/helpcontent2/source/text/scalc/01/06060000.xhp new file mode 100644 index 000000000..ae03dc323 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06060000.xhp @@ -0,0 +1,51 @@ + + + + + + + + +Protect Document +/text/scalc/01/06060000.xhp + + +Sun Microsystems, Inc. + + + +
+Protect Document +The Protect Sheet or Protect Spreadsheet Structure commands prevent changes from being made to cells in the sheets or to sheets in a document. As an option, you can define a password. If a password is defined, removal of the protection is only possible if the user enters the correct password. +
+
+ + +
+Sheets + +Documents + +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/06060100.xhp b/helpcontent2/source/text/scalc/01/06060100.xhp new file mode 100644 index 000000000..5ed52eec5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06060100.xhp @@ -0,0 +1,109 @@ + + + + + +Protecting Sheet +/text/scalc/01/06060100.xhp + + + + + + + +insert rows;protected sheet +insert columns;protected sheet +delete columns;protected sheet +delete rows;protected sheet +protected sheet;insert columns +protected sheet;insert rows +protected sheet;delete rows +protected sheet;delete columns +protect;sheet +selection;in protected cells + +

Protecting Sheet

+Protects the cells in the current sheet from being modified. +Choose Tools - Protect Sheet to open the Protect Sheet dialog in which you then specify sheet protection with or without a password, and select the elements of the sheet to protect. +
+ + +
+To protect cells from further editing, the Protected check box must be checked on the Format - Cells - Cell Protection tab page or on the Format Cells context menu. + +

Protect this sheet and contents of the protected cells

+Mark this checkbox to activate protection of sheet and cell contents. +

Password / Confirm

+Allows you to enter a password to protect the sheet from unauthorized changes. Confirm the password entered in the first box. +

Allow users of this sheet to

+Select the elements to protect from user actions: + + + Select protected cells: mark this checkbox to allow you to select protected cells. When the checkbox is unmarked, you cannot select protected cells, the cursor cannot enter in a protected range. + + + Select unprotected cells: mark this checkbox to allow user to select unprotected cells. When the checkbox is unmarked, user cannot select unprotected cells, the cursor cannot enter in a unprotected cell or range. + + + Insert columns: Allow column insertions even when the sheet is protected. Note that when column insertions is enabled, you can insert columns even when the range to insert the new columns into contains protected cells which will get shifted after the insertion. Cells of the newly inserted columns inherit the Protection property of the range it belongs: when the new cell is inside a protected range, the cell is protected, and when it is in an unprotected range, the cell is unprotected. + + + Insert rows: Allow row insertions even when the sheet is protected. Note that when row insertions is enabled, you can insert rows even when the range to insert the new rows into contains protected cells which will get shifted after the insertion. Cells of the newly inserted rows inherit the Protection property of the range it belongs: when the new cell is inside a protected range it is protected, and when it is in an unprotected range, the cell is unprotected. + + + Delete columns: Allow column deletions. Note that column deletions are only allowed on unprotected cells. + + + + Delete rows: Allow row deletions. Note that row deletions are only allowed on unprotected cells. + + + +Unprotected cells or cell ranges can be set up on a protected sheet by using the Tools - Protect Sheet and Format - Cells - Cell Protection menus: + + +Select the cells that will be unprotected + + +Select Format - Cells - Cell Protection. Unmark the Protected box and click OK. + + + On the Tools - Protect Sheet menu, activate protection for the sheet. Effective immediately, only the cell range you selected in step 1 can be edited. + + +To later change an unprotected area to a protected area: + + + Select the range of cells that will be protected. + + + On the Format - Cells - Cell Protection tab page, check the Protected box. + + + Choose the Tools - Protect Sheet menu. The previously editable range is now protected. + + +Sheet protection also affects the context menu of the sheet tabs at the bottom of the screen. The Delete and Rename commands cannot be selected. +If a sheet is protected, you will not be able to modify or delete any Cell Styles. +A protected sheet or cell range can no longer be modified until this protection is disabled, with the exceptions of the settings for columns and row of the Tools - Protect Sheet dialog. To disable the protection, choose the Tools - Protect Sheet command. If no password was set, the sheet protection is immediately disabled. If the sheet was password protected, the Remove Protection dialog opens, where you must enter the password. +Once saved, protected sheets can only be saved again by using the File - Save As command. +Complete protection of your work can be achieved by combining the options Tools - Protect Sheet and Tools - Protect Spreadsheet Structure, including password protection. To prohibit opening the document altogether, in the Save dialog mark the Save with password box before you click the Save button. + + diff --git a/helpcontent2/source/text/scalc/01/06060200.xhp b/helpcontent2/source/text/scalc/01/06060200.xhp new file mode 100644 index 000000000..20a68ae45 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06060200.xhp @@ -0,0 +1,52 @@ + + + + + + + + +Protecting document +/text/scalc/01/06060200.xhp + + +Sun Microsystems, Inc. + + + + + +Protecting document +Protects the sheet structure of your document from modifications. It is impossible to insert, delete, rename, move or copy sheets. Open the Protect spreadsheet structure dialog with Tools - Protect Spreadsheet Structure. Optionally enter a password and click OK. +
+ +
+The structure of protected spreadsheet documents can be changed only if the Protect option is disabled. On the context menus for the spreadsheet tabs at the lower graphic border, only the menu item Select All Sheets can be activated. All other menu items are deactivated. To remove the protection, call up the command Tools - Protect Spreadsheet Structure again. If no password is assigned, protection is immediately removed. If you were assigned a password, the Remove Spreadsheet Protection dialog appears, in which you must enter the password. Only then can you remove the check mark specifying that protection is active. +A protected document, once saved, can only be saved again with the File - Save As menu command. + + +Password (optional) +You can create a password to protect your document against unauthorized or accidental modifications. + + +Re-enter the password. + +You can completely protect your work by combining the options Tools - Protect Sheet and Tools - Protect Spreadsheet Structure, including password entry. If you want to prevent the document from being opened by other users, select Save With Password and click the Save button. The Enter Password dialog appears. Consider carefully when choosing a password; if you forget it after you close a document you will be unable to access the document. + + diff --git a/helpcontent2/source/text/scalc/01/06070000.xhp b/helpcontent2/source/text/scalc/01/06070000.xhp new file mode 100644 index 000000000..9f35327a6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06070000.xhp @@ -0,0 +1,45 @@ + + + + + +AutoCalculate +/text/scalc/01/06070000.xhp + + + +
+calculating; auto calculating sheets +recalculate;auto calculating sheets +recalculating;auto calculating sheets +AutoCalculate function in sheets +correcting sheets automatically +formulas;AutoCalculate function +cell contents;AutoCalculate function +mw added "recalculating;..." + +

AutoCalculate

+Automatically recalculates all formulas in the document. +
+All cells are recalculated after a sheet cell has been modified. Any charts in the sheet will also be refreshed. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/06080000.xhp b/helpcontent2/source/text/scalc/01/06080000.xhp new file mode 100644 index 000000000..dd85adf92 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06080000.xhp @@ -0,0 +1,53 @@ + + + + + + + +Recalculate +/text/scalc/01/06080000.xhp + + + +
+recalculating;all formulas in sheets +recalculate;all formulas in sheets +formulas; recalculating manually +cell contents; recalculating +mw changed "recalculating;...", "formulas;..." and "cell..." entries and deleted "recalculating formulas" + +
+

Recalculate

+Recalculates formula cells. +
+
+ +
+If AutoCalculate is disabled, the Recalculate command recalculates all (so-called dirty) formula cells that depend on changed cell content and their dependents, and formula cells containing volatile functions such as RAND() or NOW() and formula cells that depend on them. +If AutoCalculate is enabled, the Recalculate command applies only to formula cells containing volatile functions like RAND() or NOW() and formula cells that depend on them. +In either mode, with formula cell(s) selected pressing F9 recalculates the currently selected cells and formula cells that depend on them. This can be useful after reading documents with recalculation disabled and individual cells need recalculation. +Press F9 to recalculate. Press Shift+CommandCtrl+F9 to recalculate all formulas in the document, including Add-In functions and non-volatile functions. +After the document has been recalculated, the display is refreshed. All charts are also refreshed. +
+
+ Recalculation options +
+ + diff --git a/helpcontent2/source/text/scalc/01/06130000.xhp b/helpcontent2/source/text/scalc/01/06130000.xhp new file mode 100644 index 000000000..40462661a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06130000.xhp @@ -0,0 +1,61 @@ + + + + + + + + +AutoInput +/text/scalc/01/06130000.xhp + + +Sun Microsystems, Inc. + + + +entering entries with AutoInput function +capital letters;AutoInput function +mw made "entering..." a one level entry + +AutoInput +Switches the AutoInput function on and off, which automatically completes entries, based on other entries in the same column. The column is scanned up to a maximum of 2000 cells or 200 different strings. + +
+ +
+The completion text is highlighted. + + +To accept the completion, press Enter or a cursor key. + + +To append text or to edit the completion, press F2. + + +To view more completions, press CommandCtrl+Tab to scroll forward, or CommandCtrl+Shift+Tab to scroll backward. + + + To see a list of all available AutoInput text items for the current column, press OptionAlt+Down Arrow. + + +When typing formulas using characters that match previous entries, a Help tip will appear listing the last ten functions used from Function Wizard, from all defined range names, from all database range names, and from the content of all label ranges. +AutoInput is case-sensitive. If, for example, you have written "Total" in a cell, you cannot enter "total" in another cell of the same column without first deactivating AutoInput. + + diff --git a/helpcontent2/source/text/scalc/01/07080000.xhp b/helpcontent2/source/text/scalc/01/07080000.xhp new file mode 100644 index 000000000..9e0beeae1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/07080000.xhp @@ -0,0 +1,46 @@ + + + + + + + Split Window + /text/scalc/01/07080000.xhp + + + + + + +
+ + +Split Window +Divides the current window at the top left corner of the active cell. +
+ +
+ +
+ +You can also use the mouse to split the window horizontally or vertically. To do this, drag the thick black line located directly above the vertical scrollbar or directly to the right of the horizontal scrollbar into the window. A thick black line will show where the window is split. +A split window has its own scrollbars in each partial section; by contrast, fixed window sections are not scrollable. + + + diff --git a/helpcontent2/source/text/scalc/01/07090000.xhp b/helpcontent2/source/text/scalc/01/07090000.xhp new file mode 100644 index 000000000..07064520c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/07090000.xhp @@ -0,0 +1,46 @@ + + + + + + + Freeze Rows and Columns + /text/scalc/01/07090000.xhp + + + + + + +
+ + +

Freeze Rows and Columns

+Divides the sheet at the top left corner of the active cell and the area to the top left is no longer scrollable. +
+ +
+ +
+
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/07090100.xhp b/helpcontent2/source/text/scalc/01/07090100.xhp new file mode 100644 index 000000000..7e7587324 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/07090100.xhp @@ -0,0 +1,37 @@ + + + + + + + Freeze Cells + /text/scalc/01/07090100.xhp + + + + + freezing;first row + freezing;first column + freezing;cells + +
+

Freeze Cells

+Freezes the first column or the first row of the current spreadsheet. +
+
+ + +
+
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/12010000.xhp b/helpcontent2/source/text/scalc/01/12010000.xhp new file mode 100644 index 000000000..b655dee61 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12010000.xhp @@ -0,0 +1,57 @@ + + + + + + + + +Define Database Range +/text/scalc/01/12010000.xhp + + + + + + +
+

Define Range

+Defines a database range based on the selected cells in your sheet. +
+ +You can only select a rectangular cell range. +
+ +
+ +

Name

+Enter a name for the database range that you want to define, or select an existing name from the list. + +

Range

+Displays the selected cell range. + + +

Add/Modify

+Adds the selected cell range to the database range list, or modifies an existing database range. + + +

More >>

+Shows additional options. + + diff --git a/helpcontent2/source/text/scalc/01/12010100.xhp b/helpcontent2/source/text/scalc/01/12010100.xhp new file mode 100644 index 000000000..57b2a0573 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12010100.xhp @@ -0,0 +1,49 @@ + + + + + + + + +Options +/text/scalc/01/12010100.xhp + + +Sun Microsystems, Inc. + + + + + + Options + Contains column labels + Selected cell ranges contains labels. + Insert or delete cells + Automatically inserts new rows and columns into the database range in your document when new records are added to the database. To manually update the database range, choose Data - Refresh Range. + Keep formatting + Applies the existing cell format of headers and first data row to the whole database range. + Don't save imported data + Only saves a reference to the database, and not the contents of the cells. + Source: + Displays information about the current database source and any existing operators. + More << + Hides the additional options. + + diff --git a/helpcontent2/source/text/scalc/01/12020000.xhp b/helpcontent2/source/text/scalc/01/12020000.xhp new file mode 100644 index 000000000..50b18d46c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12020000.xhp @@ -0,0 +1,48 @@ + + + + + +Select Database Range +/text/scalc/01/12020000.xhp + + +Sun Microsystems, Inc. + + + +databases; selecting (Calc) + + + + + +
+

Select Range

+Selects a database range that you defined under Data - Define Range. +
+ +
+ +
+ +

Ranges

+Lists the available database ranges. To select a database range, click its name, and then click OK. + + diff --git a/helpcontent2/source/text/scalc/01/12030000.xhp b/helpcontent2/source/text/scalc/01/12030000.xhp new file mode 100644 index 000000000..5eddab9f9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12030000.xhp @@ -0,0 +1,44 @@ + + + + + +Sort +/text/scalc/01/12030000.xhp + + +Sun Microsystems, Inc. + + + + +
+

Sort

+Sorts the selected rows according to the conditions that you specify. + $[officename] automatically recognizes and selects database ranges. +
+You cannot sort data if the Record changes options is enabled. +
+ +
+ + + + + diff --git a/helpcontent2/source/text/scalc/01/12030100.xhp b/helpcontent2/source/text/scalc/01/12030100.xhp new file mode 100644 index 000000000..be87bba34 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12030100.xhp @@ -0,0 +1,61 @@ + + + + + +Sort Criteria +/text/scalc/01/12030100.xhp + + + +
+sorting; sort criteria for database ranges + + + +

Sort Criteria

+Specify the sorting options for the selected range. +
+Ensure that you include any row and column titles in the selection. +
+ +
+ + + +

Sort by

+Select the column that you want to use as the primary sort key. +

Ascending

+Sorts the selection from the lowest value to the highest value. The sorting rules are given by the locale. You can define the sort rules on Data - Sort - Options. You define the default on %PRODUCTNAME - PreferencesTools - Options - Language Settings - Languages. +

Descending

+Sorts the selection from the highest value to the lowest value. You can define the sort rules on Data - Sort - Options. You define the default on %PRODUCTNAME - PreferencesTools - Options - Language Settings - Languages. +

Then by

+Select the column that you want to use as the secondary sort key. +

Ascending

+Sorts the selection from the lowest value to the highest value. You can define the sort rules on Data - Sort - Options. You define the default on %PRODUCTNAME - PreferencesTools - Options - Language settings - Languages. +

Descending

+Sorts the selection from the highest value to the lowest value. You can define the sort rules on Data - Sort - Options. You define the default on %PRODUCTNAME - PreferencesTools - Options - Language settings - Languages. + + +

Sort Ascending/Descending

+Sorts the selection from the highest to the lowest value, or from the lowest to the highest value. Number fields are sorted by size and text fields by the order of the characters. You can define the sort rules on Data - Sort - Options. You define the default on %PRODUCTNAME - PreferencesTools - Options - Language settings - Languages. +Icons on the Standard toolbar + + + diff --git a/helpcontent2/source/text/scalc/01/12030200.xhp b/helpcontent2/source/text/scalc/01/12030200.xhp new file mode 100644 index 000000000..2dbd0cb88 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12030200.xhp @@ -0,0 +1,95 @@ + + + + + + +Options +/text/scalc/01/12030200.xhp + + +Sun Microsystems, Inc. + + + +
+sorting; options for database ranges +sorting;Asian languages +Asian languages;sorting +phonebook sorting rules +natural sort algorithm + + + +

Options

+ Sets additional sorting options. +
+
+ +
+ +

Case sensitive

+Sorts first by uppercase letters and then by lowercase letters. For Asian languages, special handling applies. +For Asian languages: Check Case Sensitive to apply multi-level collation. With multi-level collation, entries are first compared in their primitive forms with their cases and diacritics ignored. If they evaluate as the same, their diacritics are taken into account for the second-level comparison. If they still evaluate as the same, their cases, character widths, and Japanese Kana difference are considered for the third-level comparison.UFI: see #112590# and #112507# + +

Range contains row/column labels

+ Omits the first row or the first column in the selection from the sort. The Direction setting at the bottom of the dialog defines the name and function of this check box. + +

Include formats

+ Preserves the current cell formatting. + +

Enable natural sort

+Natural sort is a sort algorithm that sorts string-prefixed numbers based on the value of the numerical element in each sorted number, instead of the traditional way of sorting them as ordinary strings. For instance, let's assume you have a series of values such as, A1, A2, A3, A4, A5, A6, ..., A19, A20, A21. When you put these values into a range of cells and run the sort, it will become A1, A11, A12, A13, ..., A19, A2, A20, A21, A3, A4, A5, ..., A9. While this sorting behavior may make sense to those who understand the underlying sorting mechanism, to the rest of the population it seems completely bizarre, if not outright inconvenient. With the natural sort feature enabled, values such as the ones in the above example get sorted "properly", which improves the convenience of sorting operations in general. + +

Include boundary column(s)/row(s) containing only comments

+Range boundary columns (for sorting rows) or boundary rows (for sorting columns) of a sorting range are not sorted by default if they are empty. Check this option if boundary columns or boundary rows containing comments are also to be sorted. + +

Include boundary column(s)/row(s) containing only images

+Border columns (for sorting rows) or border rows (for sorting columns) of a sorting area are not sorted by default if they are empty. Check this option if boundary columns or boundary rows containing images are also to be sorted. + +

Copy sort results to:

+ Copies the sorted list to the cell range that you specify. + +

Sort results (named ranges list)

+ Select a named cell range where you want to display the sorted list. + +

Sort results (input box)

+Enter the cell range where you want to display the sorted list. + +

Custom sort order

+ Click here and then select the custom sort order that you want. + +

Custom sort order list

+ Select the custom sort order that you want to apply. To define a custom sort order, choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Sort Lists. +

Language

+ +

Language

+ Select the language for the sorting rules. + +

Options

+ Select a sorting option for the language. For example, select the "phonebook" option for German to include the umlaut special character in the sorting. +

Direction

+ +

Top to Bottom (Sort Rows)

+ Sorts rows by the values in the active columns of the selected range. + +

Left to Right (Sort Columns)

+ Sorts columns by the values in the active rows of the selected range. + + diff --git a/helpcontent2/source/text/scalc/01/12040000.xhp b/helpcontent2/source/text/scalc/01/12040000.xhp new file mode 100644 index 000000000..158888ea5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040000.xhp @@ -0,0 +1,44 @@ + + + + + + More Filters + /text/scalc/01/12040000.xhp + + + +
+ +

More Filters

+ Shows commands to filter your data. +
+
+ +
+ %PRODUCTNAME automatically recognizes predefined database ranges. + The following filtering options are available: +

Standard filter

+ +

Advanced filter

+ + + + + diff --git a/helpcontent2/source/text/scalc/01/12040100.xhp b/helpcontent2/source/text/scalc/01/12040100.xhp new file mode 100644 index 000000000..599def1e3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040100.xhp @@ -0,0 +1,70 @@ + + + + + +AutoFilter +/text/scalc/01/12040100.xhp + + + +
+ + + +

AutoFilter

+Automatically filters the selected cell range, and creates one-row list boxes where you can choose the items that you want to display. +
+
+ +
+ + +

Sort Ascending

+Displays the rows of the cell range in ascending order, based on the values in the cells of the current column. +

Sort Descending

+Displays the rows of the cell range in descending order, based on the values in the cells of the current column. +

Top 10

+Displays the 10 rows of the cell range that contain the largest values in the cells of the current column. If these values are unique then no more than 10 rows will be visible, but if the values are not unique then it is possible for more than 10 rows to be shown. +

Empty

+Displays only the rows of the cell range that have an empty cell in the current column. +

Not Empty

+Displays only the rows of the cell range that have a non-empty cell in the current column. +

Text color

+Displays only the rows of the cell range for which the text color of the cell in the current column matches the color selected. +

Background color

+Displays only the rows of the cell range for which the background color of the cell in the current column matches the color selected. +

Standard Filter

+Opens the Standard Filter dialog. +

Search text box

+Search for a specific entry in the list of values found in the current column. As characters are typed in the text box, this list is updated to show only matching entries. +

All

+Click once to select to show all rows and click again to select to hide all rows. +

Show only current

+Display only rows containing the value highlighted in the Value box. +

Hide only current

+Hide all rows containing the value highlighted in the Value box and display all other rows. +

Values

+List of unique values found in the current column. +
+ +Default filter +
+ + diff --git a/helpcontent2/source/text/scalc/01/12040201.xhp b/helpcontent2/source/text/scalc/01/12040201.xhp new file mode 100644 index 000000000..be0a948e1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040201.xhp @@ -0,0 +1,76 @@ + + + + + + + + Options + /text/scalc/01/12040201.xhp + + + +

Options

+ + +Shows additional filter options. + +
+ +
+

Options

+ + +
+

Case sensitive

+ Distinguishes between uppercase and lowercase letters when filtering the data. + + +

Range contains column labels

+ Includes the column labels in the first row of a cell range. + + + + + + +

Copy results to

+ Select the check box, and then select the cell range where you want to display the filter results. You can also select a named range from the list. +
+ +
+ + +

Regular expression

+ Allows you to use regular expressions in the filter definition. For a list of the regular expressions that $[officename] supports, click here. + If the Regular Expressions check box is selected, you can use regular expressions in the Value field if the Condition list box is set to '=' EQUAL or '<>' UNEQUAL. This also applies to the respective cells that you reference for an advanced filter. + + +

No duplication

+ Excludes duplicate rows in the list of filtered data. + + +

Keep filter criteria

+ Select the Copy results to check box, and then specify the destination range where you want to display the filtered data. If this box is checked, the destination range remains linked to the source range. You must have defined the source range under Data - Define range as a database range. Following this, you can reapply the defined filter at any time as follows: click into the source range, then choose Data - Refresh Range. +
+

Data range

+Displays the cell range or the name of the cell range that you want to filter. + + + diff --git a/helpcontent2/source/text/scalc/01/12040300.xhp b/helpcontent2/source/text/scalc/01/12040300.xhp new file mode 100644 index 000000000..5e5573ead --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040300.xhp @@ -0,0 +1,54 @@ + + + + + + + + Advanced Filter + /text/scalc/01/12040300.xhp + + + + + + +Advanced Filter +Defines an advanced filter. + +
+ +
+ + +Read filter criteria from +Select the named range, or enter the cell range that contains the filter criteria that you want to use. + +

Options

+ + + + + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/12040400.xhp b/helpcontent2/source/text/scalc/01/12040400.xhp new file mode 100644 index 000000000..584b426f6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040400.xhp @@ -0,0 +1,44 @@ + + + + + + + + + + +Reset Filter +/text/scalc/01/12040400.xhp + + + +
+ +Reset Filter +Removes the filter from the selected cell range. To enable this command, click inside the cell area where the filter was applied. +
+
+ +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12040500.xhp b/helpcontent2/source/text/scalc/01/12040500.xhp new file mode 100644 index 000000000..7fc8f49a3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040500.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Hide AutoFilter +/text/scalc/01/12040500.xhp + + +Sun Microsystems, Inc. + + + + + +
+ database ranges; hiding AutoFilter + +Hide AutoFilter + Hides the AutoFilter buttons in the selected cell range. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12050000.xhp b/helpcontent2/source/text/scalc/01/12050000.xhp new file mode 100644 index 000000000..be438446d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12050000.xhp @@ -0,0 +1,49 @@ + + + + + +Subtotals +/text/scalc/01/12050000.xhp + + +Sun Microsystems, Inc. + + + + + +
+

Subtotals

+ Calculates subtotals for the columns that you select. $[officename] uses the SUM function to automatically calculate the subtotal and grand total values in a labeled range. You can also use other functions to perform the calculation. $[officename] automatically recognizes a defined database area when you place the cursor in it. +
+
+ +
+ For example, you can generate a sales summary for a certain postal code based on data from a client database. + + + +

Delete

+ Deletes the subtotal rows in the selected area. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12050100.xhp b/helpcontent2/source/text/scalc/01/12050100.xhp new file mode 100644 index 000000000..fe96b4548 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12050100.xhp @@ -0,0 +1,52 @@ + + + + + +1st, 2nd, 3rd Group +/text/scalc/01/12050100.xhp + + +Sun Microsystems, Inc. + + + +
+ + +

1st, 2nd, 3rd Group

+Specify the settings for up to three subtotal groups. Each tab has the same layout. +
+
+ +
+ +

Group by

+Select the column that you want to control the subtotal calculation process. If the contents of the selected column change, the subtotals are automatically recalculated. + +

Calculate subtotals for

+Select the column(s) containing the values that you want to subtotal. + +

Use function

+Select the mathematical function that you want to use to calculate the subtotals. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12050200.xhp b/helpcontent2/source/text/scalc/01/12050200.xhp new file mode 100644 index 000000000..5e0713a21 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12050200.xhp @@ -0,0 +1,58 @@ + + + + + +Options +/text/scalc/01/12050200.xhp + + + +
+subtotals; sorting options + + + +

Options

+Specify the settings for calculating and presenting subtotals. +
+
+ +
+

Page break between groups

+Inserts a new page after each group of subtotaled data. +

Case sensitive

+Recalculates subtotals when you change the case of a data label. +

Pre-sort area according to groups

+Sorts the area that you selected in the Group by box of the Group tabs according to the columns that you selected. +

Sort

+

Include formats

+Considers formatting attributes when sorting. + +

Custom sort order

+Uses a custom sorting order that you defined in the Options dialog box at %PRODUCTNAME Calc - Sort Lists. +

Ascending

+Sorts beginning with the lowest value. You can define the sort rules on Data - Sort - Options. You define the default on %PRODUCTNAME - PreferencesTools - Options - Language settings - Languages. +

Descending

+Sorts beginning with the highest value. You can define the sort rules on Data - Sort - Options. You define the default on %PRODUCTNAME - PreferencesTools - Options - Language settings - Languages. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12060000.xhp b/helpcontent2/source/text/scalc/01/12060000.xhp new file mode 100644 index 000000000..ff0a53980 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12060000.xhp @@ -0,0 +1,56 @@ + + + + + + + + +Multiple Operations +/text/scalc/01/12060000.xhp + + + + + + +
+

Multiple Operations

+Applies the same formula to different cells, but with different parameter values. +
+ +
+ +
+ +The Row or Column box must contain a reference to the first cell of the selected range. +If you export a spreadsheet containing multiple operations to Microsoft Excel, the location of the cells containing the formula must be fully defined relative to the data range. +

Defaults

+ +

Formulas

+Enter the cell references for the cells containing the formulas that you want to use in the multiple operation. + +

Row

+Enter the input cell reference that you want to use as a variable for the rows in the data table. + +

Column

+Enter the input cell reference that you want to use as a variable for the columns in the data table. + + + diff --git a/helpcontent2/source/text/scalc/01/12070000.xhp b/helpcontent2/source/text/scalc/01/12070000.xhp new file mode 100644 index 000000000..cdf63f2d4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12070000.xhp @@ -0,0 +1,65 @@ + + + + + + + + +Consolidate +/text/scalc/01/12070000.xhp + + + + + + + +
+

Consolidate

+Combines data from one or more independent cell ranges and calculates a new range using the function that you specify. +
+ +
+ +
+ +

Function

+Select the function that you want to use to consolidate the data. + +

Consolidation ranges

+Displays the cell ranges that you want to consolidate. + + +

Source data range

+Specifies the cell range that you want to consolidate with the cell ranges listed in the Consolidation ranges box. Select a cell range in a sheet, and then click Add. You can also select the name of a predefined cell from the Source data range list. + + + +

Copy results to

+Displays the first cell in the range where the consolidation results will be displayed. + + +

Add

+Adds the cell range specified in the Source data range box to the Consolidation ranges box. + +

Options

+Shows additional options. + + diff --git a/helpcontent2/source/text/scalc/01/12070100.xhp b/helpcontent2/source/text/scalc/01/12070100.xhp new file mode 100644 index 000000000..ef860a214 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12070100.xhp @@ -0,0 +1,49 @@ + + + + + + + + +Consolidate by +/text/scalc/01/12070100.xhp + + +Sun Microsystems, Inc. + + + + + + Consolidate by + Consolidate by + Use this section if the cell ranges that you want to consolidate contain labels. You only need to select these options if the consolidation ranges contain similar labels and the data arranged is arranged differently. + Row labels + Uses the row labels to arrange the consolidated data. + Column labels + Uses the column labels to arrange the consolidated data. + Options + Link to source data + Links the data in the consolidation range to the source data, and automatically updates the results of the consolidation when the source data is changed. + Options + Hides the additional options. + + + diff --git a/helpcontent2/source/text/scalc/01/12080000.xhp b/helpcontent2/source/text/scalc/01/12080000.xhp new file mode 100644 index 000000000..0497321b2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080000.xhp @@ -0,0 +1,55 @@ + + + + + + + + +Group and Outline +/text/scalc/01/12080000.xhp + + +Sun Microsystems, Inc. + + + +
+sheets; outlines +outlines; sheets +hiding; sheet details +showing; sheet details +grouping;cells + +Group and Outline +You can create an outline of your data and group rows and columns together so that you can collapse and expand the groups with a single click. +
+
+ +
+ + +Group + +Ungroup + + + + + diff --git a/helpcontent2/source/text/scalc/01/12080100.xhp b/helpcontent2/source/text/scalc/01/12080100.xhp new file mode 100644 index 000000000..875d6109b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080100.xhp @@ -0,0 +1,46 @@ + + + + + + + + +Hide Details +/text/scalc/01/12080100.xhp + + +Sun Microsystems, Inc. + + + + + +
+ sheets; hiding details + +Hide Details + Hides the details of the grouped row or column that contains the cursor. To hide all of the grouped rows or columns, select the outlined table, and then choose this command. +
+ To show all hidden groups, select the outlined table, and then choose Data - Group and Outline – Show Details. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12080200.xhp b/helpcontent2/source/text/scalc/01/12080200.xhp new file mode 100644 index 000000000..6ff0529cf --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080200.xhp @@ -0,0 +1,47 @@ + + + + + + + + + + +Show Details +/text/scalc/01/12080200.xhp + + + +
+tables; showing details + + +Show Details +Shows the details of the grouped row or column that contains the cursor. To show the details of all of the grouped rows or columns, select the outlined table, and then choose this command. +
+To hide a selected group, choose Data - Group and Outline – Hide Details. +
+ +
+
+Show Details command in pivot tables +
+ + diff --git a/helpcontent2/source/text/scalc/01/12080300.xhp b/helpcontent2/source/text/scalc/01/12080300.xhp new file mode 100644 index 000000000..cf4872faa --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080300.xhp @@ -0,0 +1,54 @@ + + + + + + + + +Group +/text/scalc/01/12080300.xhp + + +Sun Microsystems, Inc. + + + + + +
+ + + +Group +
+ Defines the selected cell range as a group of rows or columns. +
+ +
+ When you group a cell range, and outline icon appears in the margins next to the group. To hide or show the group, click the icon. To ungroup the selection, choose Data – Group and Outline - Ungroup. + Include + Rows + Groups the selected rows. + Columns + Groups the selected columns. + Grouping and ungrouping is not tracked. Group is greyed out when track changes is on. + + + diff --git a/helpcontent2/source/text/scalc/01/12080400.xhp b/helpcontent2/source/text/scalc/01/12080400.xhp new file mode 100644 index 000000000..f34436406 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080400.xhp @@ -0,0 +1,49 @@ + + + + + + + + +Ungroup +/text/scalc/01/12080400.xhp + + +Sun Microsystems, Inc. + + + + + +
+ +Ungroup +
+ Ungroups the selection. In a nested group, the last rows or columns that were added are removed from the group. +
+ +
+ Deactivate for + Rows + Removes selected rows from a group. + Columns + Removes selected columns from a group. + + diff --git a/helpcontent2/source/text/scalc/01/12080500.xhp b/helpcontent2/source/text/scalc/01/12080500.xhp new file mode 100644 index 000000000..35e0b4e1d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080500.xhp @@ -0,0 +1,93 @@ + + + + + +AutoOutline +/text/scalc/01/12080500.xhp + + + +
+ +

AutoOutline

+If the selected cell range contains formulas or references, $[officename] automatically outlines the selection. +
+
+ +
+For example, consider the following table: + + + +January + + +February + + +March + + +1st Quarter + + +April + + +May + + +June + + +2nd Quarter + + + + +100 + + +120 + + +130 + + +350 + + +100 + + +100 + + +200 + + +400 + + +
+The cells for the 1st and 2nd quarters each contain a sum formula for the three cells to their left. If you apply the AutoOutline command, the table is grouped into two quarters. +To remove the outline, select the table, and then choose Data - Group and Outline - Remove. + + diff --git a/helpcontent2/source/text/scalc/01/12080600.xhp b/helpcontent2/source/text/scalc/01/12080600.xhp new file mode 100644 index 000000000..56cb208fb --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080600.xhp @@ -0,0 +1,44 @@ + + + + + + + + +Remove +/text/scalc/01/12080600.xhp + + +Sun Microsystems, Inc. + + + + + +
+ +Remove + Removes the outline from the selected cell range. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12080700.xhp b/helpcontent2/source/text/scalc/01/12080700.xhp new file mode 100644 index 000000000..b3ccd7df7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080700.xhp @@ -0,0 +1,40 @@ + + + + + + + + + + +Show Details (Pivot Table) +/text/scalc/01/12080700.xhp + + + +
+Show Details (Pivot Table) +Inserts a new "drill-down" sheet with more information about the current pivot table cell. You can also double-click a pivot table cell to insert the "drill-down" sheet. The new sheet shows a subset of rows from the original data source that constitutes the result data displayed in the current cell. +
+
+ +
Hidden items are not evaluated, the rows for the hidden items are included. Show Details is available only for pivot tables that are based on cell ranges or database data. + + diff --git a/helpcontent2/source/text/scalc/01/12090000.xhp b/helpcontent2/source/text/scalc/01/12090000.xhp new file mode 100644 index 000000000..c8d6b564d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090000.xhp @@ -0,0 +1,41 @@ + + + + + +Pivot Table +/text/scalc/01/12090000.xhp + + + +
+

Pivot Table

+A pivot table provides a summary of large amounts of data. You can then rearrange the pivot table to view different summaries of the data. +
+
+ +
+ +

Create

+ + + +Pivot table dialog + + diff --git a/helpcontent2/source/text/scalc/01/12090100.xhp b/helpcontent2/source/text/scalc/01/12090100.xhp new file mode 100644 index 000000000..7a9d61c48 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090100.xhp @@ -0,0 +1,53 @@ + + + + + +Select Source +/text/scalc/01/12090100.xhp + + + + + + +
+

Pivot Table - Select Source

+
+Opens a dialog where you can select the source for your pivot table, and then create your table. +
+
+
+ +
+

Selection

+Select a data source for the pivot table. + +

Current Selection

+Uses the selected cells as the data source for the pivot table. +The data columns in the pivot table use the same number format as the first data row in the current selection. + +

Data source registered in $[officename]

+Uses a table or query in a database that is registered in $[officename] as the data source for the pivot table. + +

External source/interface

+Opens the External Source dialog where you can select the OLAP data source for the pivot table. +Pivot table dialog + + diff --git a/helpcontent2/source/text/scalc/01/12090101.xhp b/helpcontent2/source/text/scalc/01/12090101.xhp new file mode 100644 index 000000000..734309ac4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090101.xhp @@ -0,0 +1,57 @@ + + + + + + + + + + +Select Data Source +/text/scalc/01/12090101.xhp + + +Sun Microsystems, Inc. + + + + + +Select Data Source +Select the database and the table or query containing the data that you want to use. +
+ +
+Selection +You can only select databases that are registered in %PRODUCTNAME. To register a data source, choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Base - Databases. + +Database +Select the database that contains the data source that you want to use. + +Data source +Select the data source that you want to use. + +Type +Click the source type of for the selected data source. You can choose from four source types: "Table", "Query" and "SQL" or SQL (Native). +
+Pivot table dialog +
+ + diff --git a/helpcontent2/source/text/scalc/01/12090102.xhp b/helpcontent2/source/text/scalc/01/12090102.xhp new file mode 100644 index 000000000..bbef6e234 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090102.xhp @@ -0,0 +1,107 @@ + + + + + + + + + Pivot Table + /text/scalc/01/12090102.xhp + + + +pivot table function;show details +pivot table function;drill down + + + + +Pivot Table + Specify the layout of the table that is generated by the pivot table. +
+ +
+ + The pivot table displays data fields as buttons which you can drag and drop to define the pivot table. + + + + +UFI: changed help id from 59001 to dply_page +Layout + To define the layout of a pivot table, drag and drop data field buttons onto the Filters, Row Fields, Column Fields and Data Fields areas. You can also use drag and drop to rearrange the data fields on a pivot table. + $[officename] automatically adds a caption to buttons that are dragged into the Data Fields area. The caption contains the name of the data field as well as the formula that created the data. + To change the function that is used by a data field, double-click a button in the Data Fields area to open the Data Field dialog. You can also double-click buttons in the Row Fields or Column Fields areas. + +More + Displays or hides additional options for defining the pivot table. + Result + Specify the settings for displaying the results of the pivot table. + + +Selection from + Select the area that contains the data for the current pivot table. + + +Results to + Select the area where you want to display the results of the pivot table. + + If the selected area contains data, the pivot table overwrites the data. To prevent the loss of existing data, let the pivot table automatically select the area to display the results. + +Ignore empty rows + Ignores empty fields in the data source. + +Identify categories + Automatically assigns rows without labels to the category of the row above.i93137 + +Total columns + Calculates and displays the grand total of the column calculation. + +Total rows + Calculates and displays the grand total of the row calculation. + +Add filter + Adds a Filter button to pivot tables that are based on spreadsheet data. + +Opens the Filter dialog. + +Enable drill to details + Select this check box and double-click an item label in the table to show or hide details for the item. Clear this check box and double-click a cell in the table to edit the contents of the cell. + To examine details inside a pivot table + Do one of the following: + + + Select a range of cells and choose Data - Group and Outline - Show Details. + + + Double-click a field in the table. + + + If you double-click a field which has adjacent fields at the same level, the Show Detail dialog opens: + + + +Show Detail + Choose the field that you want to view the details for. +
+ Pivot table shortcut keys +
+ + diff --git a/helpcontent2/source/text/scalc/01/12090103.xhp b/helpcontent2/source/text/scalc/01/12090103.xhp new file mode 100644 index 000000000..950e1a3a4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090103.xhp @@ -0,0 +1,114 @@ + + + + + + + + +Filter +/text/scalc/01/12090103.xhp + + +Sun Microsystems, Inc. + + + + + + + Filter + Set the filtering options for the data. + Filter Criteria + You can define a default filter for the data by filtering, for example, field names, using a combination of logical expressions arguments. + Operator + Select a logical operator for the filter. + Field name + Select the field that you want to use in the filter. If field names are not available, the column labels are listed. + Condition + Select an operator to compare the Field name and Value entries. + The following operators are available: + + + + + + + Conditions: + + + + + + + + + = + + + equal + + + + + < + + + less than + + + + + > + + + greater than + + + + + <= + + + less than or equal to + + + + + >= + + + greater than or equal to + + + + + <> + + + not equal to + + +
+ Value + Select the value that you want to compare to the selected field. + Options + + + diff --git a/helpcontent2/source/text/scalc/01/12090104.xhp b/helpcontent2/source/text/scalc/01/12090104.xhp new file mode 100644 index 000000000..d1cb4888d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090104.xhp @@ -0,0 +1,52 @@ + + + + + + + + +Options +/text/scalc/01/12090104.xhp + + +Sun Microsystems, Inc. + + + + + + + Options + Displays or hides additional filtering options. + Options + Case sensitive + Distinguishes between uppercase and lowercase letters. + Regular Expression + Allows you to use regular expressions in the filter definition. + If the Regular Expression check box is selected, you can use EQUAL (=) and NOT EQUAL (<>) also in comparisons. You can also use the following functions: DCOUNTA, DGET, MATCH, COUNTIF, SUMIF, LOOKUP, VLOOKUP and HLOOKUP. + No duplications + Excludes duplicate rows in the list of filtered data. + Data range + Displays the name of the filtered data range in the table. +
+ List of Regular Expressions +
+ + diff --git a/helpcontent2/source/text/scalc/01/12090105.xhp b/helpcontent2/source/text/scalc/01/12090105.xhp new file mode 100644 index 000000000..bdde49582 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090105.xhp @@ -0,0 +1,168 @@ + + + + + + + + +Data field +/text/scalc/01/12090105.xhp + + + + + + + +calculating;pivot table + +Data field +The contents of this dialog is different for data fields in the Data area, and data fields in the Row or Column area of the Pivot Table dialog. +Subtotals +Specify the subtotals that you want to calculate. +None +Does not calculate subtotals. +Automatic +Automatically calculates subtotals. +User-defined +Select this option, and then click the type of subtotal that you want to calculate in the list. + + +Function +Click the type of subtotal that you want to calculate. This option is only available if the User-defined option is selected. + + +Show items without data +Includes empty columns and rows in the results table. +Name: +Lists the name of the selected data field. + +More +Expands or reduces the dialog. The More button is visible for data fields only. + +Options +Opens the Data Field Options dialog. The Options button is visible for filters and column or row fields only. +If the dialog is expanded by the More button, the following items are added to the dialog: +Displayed value +For each data field, you can select the type of display. For some types you can select additional information for a base field and a base item. + +Type +Select the type of calculating of the displayed value for the data field. + + + +Type + + +Displayed value + + + + +Normal + + +Results are shown unchanged + + + + +Difference from + + +From each result, its reference value (see below) is subtracted, and the difference is shown. Totals outside of the base field are shown as empty results. + +Named item + +If a base item name is specified, the reference value for a combination of field items is the result where the item in the base field is replaced by the specified base item. + +Previous item or Next item + +If "previous item" or "next item" is specified as the base item, the reference value is the result for the next visible member of the base field, in the base field's sort order. + + + + +% Of + + +Each result is divided by its reference value. The reference value is determined in the same way as for "Difference from". Totals outside of the base field are shown as empty results. + + + + +% Difference from + + +From each result, its reference value is subtracted, and the difference is divided by the reference value. The reference value is determined in the same way as for "Difference from". Totals outside of the base field are shown as empty results. + + + + +Running total in + + +Each result is added to the sum of the results for preceding items in the base field, in the base field's sort order, and the total sum is shown. +Results are always summed, even if a different summary function was used to get each result. + + + + +% of row + + +Each result is divided by the total result for its row in the pivot table. If there are several data fields, the total for the result's data field is used. If there are subtotals with manually selected summary functions, the total with the data field's summary function is still used. + + + + +% of column + + +Same as "% of row", but the total for the result's column is used. + + + + +% of total + + +Same as "% of row", but the grand total for the result's data field is used. + + + + +Index + + +The row and column totals and the grand total, following the same rules as above, are used to calculate the following expression: +( original result * grand total ) / ( row total * column total ) + + +
+ + +Base field +Select the field from which the respective value is taken as base for the calculation. + +Base item +Select the item of the base field from which the respective value is taken as base for the calculation. + + diff --git a/helpcontent2/source/text/scalc/01/12090106.xhp b/helpcontent2/source/text/scalc/01/12090106.xhp new file mode 100644 index 000000000..2cde7124c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090106.xhp @@ -0,0 +1,70 @@ + + + + + + + + + + +Data Field Options +/text/scalc/01/12090106.xhp + + + +hiding;data fields, from calculations in pivot table +display options in pivot table +sorting;options in pivot table +data field options for pivot table +mw changed "hiding..." entry + +Data Field Options +You can specify additional options for column, row, and page data fields in the pivot table. +Sort by +Select the data field that you want to sort columns or rows by. +Ascending +Sorts the values from the lowest value to the highest value. If the selected field is the field for which the dialog was opened, the items are sorted by name. If a data field was selected, the items are sorted by the resultant value of the selected data field. +Descending +Sorts the values descending from the highest value to the lowest value. If the selected field is the field for which the dialog was opened, the items are sorted by name. If a data field was selected, the items are sorted by the resultant value of the selected data field. +Manual +Sorts values alphabetically.UFI: see spec doc. Currently set to alphabetically. +Display options +You can specify the display options for all row fields except for the last, innermost row field. +Layout +Select the layout mode for the field in the list box. +Empty line after each item +Adds an empty row after the data for each item in the pivot table. +Show automatically +Displays the top or bottom nn items when you sort by a specified field. +Show +Turns on the automatic show feature. +items +Enter the maximum number of items that you want to show automatically. +From +Shows the top or bottom items in the specified sort order. +Using field +Select the data field that you want to sort the data by. +Hide items +Select the items that you want to hide from the calculations. +Hierarchy +Select the hierarchy that you want to use. The pivot table must be based on an external source data that contains data hierarchies. + Calc does not provide multiple hierarchies for a single field and so this option is normally grayed. If you use a pivot table data source extension, that extension could define multiple hierarchies for some fields and then the option could become available. See the documentation supplied with that extension for more details. + + diff --git a/helpcontent2/source/text/scalc/01/12090200.xhp b/helpcontent2/source/text/scalc/01/12090200.xhp new file mode 100644 index 000000000..581dcdb4b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090200.xhp @@ -0,0 +1,43 @@ + + + + + + + + +Refresh +/text/scalc/01/12090200.xhp + + +Sun Microsystems, Inc. + + + +
+ +Refresh +Updates the pivot table. +
+After you import an Excel spreadsheet that contains a pivot table, click in the table, and then choose Data - Pivot Table - Refresh. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12090300.xhp b/helpcontent2/source/text/scalc/01/12090300.xhp new file mode 100644 index 000000000..6b030209e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090300.xhp @@ -0,0 +1,39 @@ + + + + + + + + +Delete +/text/scalc/01/12090300.xhp + + + +
+ +Delete +Deletes the selected pivot table. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12090400.xhp b/helpcontent2/source/text/scalc/01/12090400.xhp new file mode 100644 index 000000000..4a4cfc4d2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090400.xhp @@ -0,0 +1,59 @@ + + + + + + + + +Grouping +/text/scalc/01/12090400.xhp + + + +Grouping +Grouping pivot tables displays the Grouping dialog for either values or dates. +
+ +
+Start +Specifies the start of the grouping. +Automatically +Specifies whether to start grouping at the smallest value. +Manually at +Specifies whether to enter the start value for grouping yourself. +End +Specifies the end of the grouping. +Automatically +Specifies whether to end grouping at the largest value. +Manually at +Specifies whether to enter the end value for grouping yourself. +Group by +Specifies the value range by which every group's limits are calculated. +Number of days +In the case of grouping date values, specifies the number of days to group by. +Intervals +In the case of grouping date values, specifies the intervals to group by. +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/12100000.xhp b/helpcontent2/source/text/scalc/01/12100000.xhp new file mode 100644 index 000000000..d5bf15765 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12100000.xhp @@ -0,0 +1,41 @@ + + + + + +Refresh Range +/text/scalc/01/12100000.xhp + + +Sun Microsystems, Inc. + + + + database ranges; refreshing + + +
+

Refresh Range

+ Updates a data range that was inserted from an external database. The data in the sheet is updated to match the data in the external database. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/12120000.xhp b/helpcontent2/source/text/scalc/01/12120000.xhp new file mode 100644 index 000000000..d2c131042 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120000.xhp @@ -0,0 +1,45 @@ + + + + + +Validity +/text/scalc/01/12120000.xhp + + +Sun Microsystems, Inc. + + + + +
+

Validity

+Defines what data is valid for a selected cell or cell range. + +
+
+ +
+You can also insert a list box from the Controls toolbar and link the list box to a cell. This way you can specify the valid values on the Data page of the list box properties window. + + + + + + diff --git a/helpcontent2/source/text/scalc/01/12120100.xhp b/helpcontent2/source/text/scalc/01/12120100.xhp new file mode 100644 index 000000000..ada387093 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120100.xhp @@ -0,0 +1,157 @@ + + + + + + +Criteria +/text/scalc/01/12120100.xhp + + +Sun Microsystems, Inc. + + + +
+selection lists;validity +UFI added index entry for new list feature. Guide needed. MW changed index entry + + +

Criteria

+Specify the validation rules for the selected cell(s). +
+
+ +
+For example, you can define criteria such as: "Numbers between 1 and 10" or "Texts that are no more than 20 characters". + +

Allow

+Click a validation option for the selected cell(s). +The following conditions are available: + + + +Condition + + +Effect + + + + +All values + + +No limitation. + + + + +Whole numbers + + +Only whole numbers corresponding to the condition. + + + + +Decimal + + +All numbers corresponding to the condition. + + + + +Date + + +All numbers corresponding to the condition. The entered values are formatted accordingly the next time the dialog is called up. + + + + +Time + + +All numbers corresponding to the condition. The entered values are formatted accordingly the next time the dialog is called up. + + + + +Cell range + + +Allow only values that are given in a cell range. The cell range can be specified explicitly, or as a named database range, or as a named range. The range may consist of one column or one row of cells. If you specify a range of columns and rows, only the first column is used. + + + + +List + + +Allow only values or strings specified in a list. Strings and values can be mixed. Numbers evaluate to their value, so if you enter the number 1 in the list, the entry 100% is also valid. Only up to 255 characters are saved, when using Excel format. + + + + +Text length + + +Entries whose length corresponds to the condition. + + + + +Custom + + +Only allow values that result in the formula entered in the Formula box to return TRUE, when the formula is calculated with the entered value. The formula can be any expression that evaluates to a boolean value of TRUE or FALSE, or returns a numerical value, where a nonzero value is interpreted as TRUE and 0 is interpreted as FALSE. +Formulas can use relative referencing. For example, if cells A1:A4 were selected, the cursor is in cell A1 and ISODD(A1) is entered into the Formula box, then only odd numbers could be entered into cells A1 through A4. + + +
+ + +

Allow blank cells

+In conjunction with Tools - Detective - Mark invalid Data, this defines that blank cells are shown as invalid data (disabled) or not (enabled). + +

Show selection list

+Shows a list of all valid strings or values to select from. The list can also be opened by selecting the cell and pressing Command+DCtrl+D. + +

Sort entries ascending

+Sorts the selection list in ascending order and filters duplicates from the list. If not checked, the order from the data source is taken. +

Source

+Enter the cell range that contains the valid values or text. + +Entries +Enter the entries that will be valid values or text strings. + +Data +Select the comparative operator that you want to use. The available operators depend on what you selected in the Allow box. If you select "between" or "not between", the Minimum and Maximum input boxes appear. Otherwise, only the Minimum, the Maximum, or the Value input boxes appear. +Value +Enter the value for the data validation option that you selected in the Allow box. + +

Minimum

+Enter the minimum value for the data validation option that you selected in the Allow box. + +Maximum +Enter the maximum value for the data validation option that you selected in the Allow box. + + diff --git a/helpcontent2/source/text/scalc/01/12120200.xhp b/helpcontent2/source/text/scalc/01/12120200.xhp new file mode 100644 index 000000000..f78ac4ac0 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120200.xhp @@ -0,0 +1,54 @@ + + + + + + + + +Input Help +/text/scalc/01/12120200.xhp + + +Sun Microsystems, Inc. + + + +
+ + +Input Help +Enter the message that you want to display when the cell or cell range is selected in the sheet. +
+
+ +
+ +Show input help when cell is selected +Displays the message that you enter in the Contents box when the cell or cell range is selected in the sheet. +If you enter text in the Contents box of this dialog, and then select and clear this check box, the text will be lost. +Contents + +Title +Enter the title that you want to display when the cell or cell range is selected. + +Input help +Enter the message that you want to display when the cell or cell range is selected. + + diff --git a/helpcontent2/source/text/scalc/01/12120300.xhp b/helpcontent2/source/text/scalc/01/12120300.xhp new file mode 100644 index 000000000..4b0079d65 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120300.xhp @@ -0,0 +1,83 @@ + + + + + + + Error Alert + /text/scalc/01/12120300.xhp + + + Sun Microsystems, Inc. + + + +
+ + + Error Alert + Defines the error message that is displayed when invalid data is entered in a cell. +
+You can also start a macro with an error message. A sample macro is provided at the end of this page. +
+ +
+ +Show error message when invalid values are entered. +Displays the error message that you enter in the Contents area when invalid data is entered in a cell. If enabled, the message is displayed to prevent an invalid entry. +In both cases, if you select "Stop", the invalid entry is deleted and the previous value is reentered in the cell. The same applies if you close the "Warning" and "Information" dialogs by clicking the Cancel button. If you close the dialogs with the OK button, the invalid entry is not deleted. +Contents + +Action +Select the action that you want to occur when invalid data is entered in a cell. The "Stop" action rejects the invalid entry and displays a dialog that you have to close by clicking OK. The "Warning" and "Information" actions display a dialog that can be closed by clicking OK or Cancel. The invalid entry is only rejected when you click Cancel. + +Browse +Opens the Macro dialog where you can select the macro that is executed when invalid data is entered in a cell. The macro is executed after the error message is displayed. + +Title +Enter the title of the macro or the error message that you want to display when invalid data is entered in a cell. + +Error message +Enter the message that you want to display when invalid data is entered in a cell. +

Sample macro:

+ Below is a sample function that can be called when an error occurs. Note that the macro takes in two parameters that are passed on by %PRODUCTNAME when the function is called: + + + CellValue: The value entered by the user, as a String. + + + CellAddress: The address of the cell where the value was entered, as a String prefixed with the sheet name (e.g: "Sheet1.A1"). + + + The function must return a Boolean value. If it returns True, the entered value is kept. If the function returns False, the entered value is erased and the previous value is restored. + + Function ExampleValidity(CellValue as String, CellAddress as String) as Boolean + Dim msg as String + Dim iAnswer as Integer + Dim MB_FLAGS as Integer + msg = "Invalid value: " & "'" & CellValue & "'" + msg = msg & " in cell: " & "'" & CellAddress & "'" + msg = msg & Chr(10) & "Accept anyway?" + MB_FLAGS = MB_YESNO + MB_ICONEXCLAMATION + MB_DEFBUTTON2 + iAnswer = MsgBox (msg , MB_FLAGS, "Error message") + ExampleValidity = (iAnswer = IDYES) + End Function + + + diff --git a/helpcontent2/source/text/scalc/01/ODFF.xhp b/helpcontent2/source/text/scalc/01/ODFF.xhp new file mode 100644 index 000000000..1ef91d5fa --- /dev/null +++ b/helpcontent2/source/text/scalc/01/ODFF.xhp @@ -0,0 +1,25 @@ + + + + + +ODFF +/text/scalc/01/ODFF.xhp + + + +
+This function is part of the Open Document Format for Office Applications (OpenDocument) standard Version 1.2. (ISO/IEC 26300:2-2015) +
+
+This function is part of the Open Document Format for Office Applications (OpenDocument) standard Version 1.3. +
+ + diff --git a/helpcontent2/source/text/scalc/01/calculate.xhp b/helpcontent2/source/text/scalc/01/calculate.xhp new file mode 100644 index 000000000..ab06f421b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/calculate.xhp @@ -0,0 +1,32 @@ + + + + + + + Calculate + /text/scalc/01/calculate.xhp + + + +
+ +

Calculate

+ Commands to calculate formula cells. +
+
+ Choose Data - Calculate +
+ + + + + + diff --git a/helpcontent2/source/text/scalc/01/calculation_accuracy.xhp b/helpcontent2/source/text/scalc/01/calculation_accuracy.xhp new file mode 100644 index 000000000..297178db5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/calculation_accuracy.xhp @@ -0,0 +1,108 @@ + + + + + + + Calculation Accuracy + /text/scalc/01/calculation_accuracy.xhp + + + + + calculation;accuracy + precision;calculation + +
+

%PRODUCTNAME Calculation Accuracy

+
+

Inherent Accuracy Problem

+ %PRODUCTNAME Calc, just like most other spreadsheet software, uses floating-point math capabilities available on hardware. Given that most contemporary hardware uses binary floating-point arithmetic with limited precision defined in IEEE 754 standard, many decimal numbers - including as simple as 0.1 - cannot be precisely represented in %PRODUCTNAME Calc (which uses 64-bit double-precision numbers internally). + Calculations with those numbers necessarily results in rounding errors, and those accumulate with every calculation. + + This is not a bug, but is expected and currently unavoidable without using complex calculations in software, which would incur inappropriate performance penalties, and thus is out of question. Users need to account for that, and use rounding and comparisons with machine epsilon (or unit roundoff) as necessary. + An example with numbers: + + + + + + A + + + + + 1 + + + 31000.99 + + + + + 2 + + + 32000.12 + + + + + 3 + + + =A1-A2 + + +
+ This will result in -999.129999999997 in A3, instead of expected -999.13 (you might need to increase shown decimal places in cell format to see this). +An example with dates and times: + Due to the specific of time representation in Calc, this also applies to all calculations involving times. For example, the cells A1 and A2 below show the date and time data as entered (in ISO 8601 format): + + + + + + A + + + + + 1 + + + 2020-04-13 12:18:00 + + + + + 2 + + + 2020-04-13 12:08:00 + + + + + 3 + + + =A1-A2 + + +
+ Cell A3 will show 00:10:00 if the default formatting [HH]:MM:SS is applied to the cell. However, cell A3 will show 00:09:59.999999 instead of expected 00:10:00.000000 if formatted using [HH]:MM:SS.000000 format string. This happens despite only whole numbers of hours and minutes were used, because internally, any time is a fraction of a day, 12:00 (noon) being represented as 0.5. + The data in A1 is represented internally as 43934.5125, and in A2 as 43934.5055555555591126903891563 (which is not exact representation of the entered datetime, which would be 43934.505555555555555555...). + Their subtraction results in 0.00694444443287037, a value slightly less than expected 0.00694444444444..., which is 10 minutes. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/cell_styles.xhp b/helpcontent2/source/text/scalc/01/cell_styles.xhp new file mode 100644 index 000000000..eb5780668 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/cell_styles.xhp @@ -0,0 +1,38 @@ + + + + + + + Cell Styles + /text/scalc/01/cell_styles.xhp + + + + +
+

Cell Styles

+
+ +
+ +
+ + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/01/common_func.xhp b/helpcontent2/source/text/scalc/01/common_func.xhp new file mode 100644 index 000000000..3ec6b8e0b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/common_func.xhp @@ -0,0 +1,40 @@ + + + + + + Common Syntax and example + /text/scalc/01/common_func.xhp + + + +
+

Syntax

+
+
+

Example

+
+
+

Examples

+
+
+

Technical information

+
+
+

See also

+
+
+ This function is not part of the Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format standard. The name space is +
+
+ This function ignores any text or empty cell within a data range. If you suspect wrong results from this function, look for text in the data ranges. To highlight text contents in a data range, use the value highlighting feature. +
+ + diff --git a/helpcontent2/source/text/scalc/01/common_func_workdaysintl.xhp b/helpcontent2/source/text/scalc/01/common_func_workdaysintl.xhp new file mode 100644 index 000000000..cc515b8e7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/common_func_workdaysintl.xhp @@ -0,0 +1,163 @@ + + + + + + + common workdays intl + /text/scalc/01/common_func_workdaysintl.xhp + + + + + + +
+Weekend is an optional parameter – a number or a string used to specify the days of the week that are weekend days and are not considered working days. Weekend is a weekend number or string that specifies when weekends occur. Weekend number values indicate the following weekend days: +Number 1 to 7 for two-day weekends and 11 to 17 for one-day weekends. + + + + + Number + + + Weekend + + + + + 1 or omitted + + + Saturday and Sunday + + + + + 2 + + + Sunday and Monday + + + + + 3 + + + Monday and Tuesday + + + + + 4 + + + Tuesday and Wednesday + + + + + 5 + + + Wednesday and Thursday + + + + + 6 + + + Thursday and Friday + + + + + 7 + + + Friday and Saturday + + + + + 11 + + + Sunday only + + + + + 12 + + + Monday only + + + + + 13 + + + Tuesday only + + + + + 14 + + + Wednesday only + + + + + 15 + + + Thursday only + + + + + 16 + + + Friday only + + + + + 17 + + + Saturday only + + +
+ +Weekend string provides another way to define the weekly non-working days. It must have seven (7) characters – zeros (0) for working day and ones (1) for non-working day. Each character represents a day of the week, starting with Monday. Only 1 and 0 are valid. “1111111” is an invalid string and should not be used. For example, the weekend string “0000011” defines Saturday and Sunday as non-working days. +Holidays is an optional list of dates that must be counted as non-working days. The list can be given in a cell range. +
+ + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/data_form.xhp b/helpcontent2/source/text/scalc/01/data_form.xhp new file mode 100644 index 000000000..b65c81740 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/data_form.xhp @@ -0,0 +1,72 @@ + + + + + + + Data Entry Form for Spreadsheet + /text/scalc/01/data_form.xhp + + + + + + + + data entry forms;for spreadsheets + data entry forms;insert data in spreadsheets + insert data;data entry forms for spreadsheets + spreadsheet;form for inserting data + +
+

Form

+ Data Entry Form is a tool to make table data entry easy in spreadsheets. With the Data Entry Form, you can enter, edit and delete records (or rows) of data and avoid horizontal scrolling when the table has many columns or when some columns are very wide. +
+ +
+ Choose Data – Form... +
+ +

Preparing the data entry form

+ To be effective, the Calc data table should have a header row, where each cell contents is the label of the column. The header cells contents become the label of each data field in the form. + +

Activating the form

+ + + Place the cursor in the header row of the table. + + + Choose Data - Form.... + + +

Filling the form with data

+ Enter the data in the text fields. Press Enter or click New to add it to the table. +

Form dialog buttons

+ New: fill the record (table row cells) with the form fields contents and jump to the next record or add a new record in the bottom of the table. + Delete: deletes the current record. + Restore: when a form field is edited, restore the record contents to its initial state. + Previous record: move to the previous record (table row). + Next record: move to the next record. + Close: close the form. + + + The form dialog box and header row cells as field labels + + + Use the Tab and Shift-Tab keys to jump forth and back between text boxes of the form dialog. + You also can use the form scroll bar to move between text boxes. +

Reopening the form dialog

+ To reopen the form dialog, place the cursor on the header row and open the form. The displayed record in the form dialog is the first data record. Move to the last record before entering new data otherwise the current record will be edited. +
+ Document Forms +
+ + + diff --git a/helpcontent2/source/text/scalc/01/data_provider.xhp b/helpcontent2/source/text/scalc/01/data_provider.xhp new file mode 100644 index 000000000..b7714b2d9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/data_provider.xhp @@ -0,0 +1,52 @@ + + + + + + + Data Provider for Spreadsheet + /text/scalc/01/data_provider.xhp + + + + + + + + + +data provider;for spreadsheets + + +
+

Data Provider for Spreadsheets

+Data Provider for Spreadsheets +
+ +
+Menu Data – Data Provider... +
+ + +
+Data Provider +
+ + + diff --git a/helpcontent2/source/text/scalc/01/databar_more_options.xhp b/helpcontent2/source/text/scalc/01/databar_more_options.xhp new file mode 100644 index 000000000..97fee0d3e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/databar_more_options.xhp @@ -0,0 +1,73 @@ + + + + + + + Databar More Options + /text/scalc/01/databar_more_options.xhp + + + + + + +conditional formatting;data bar options +data bar formatting;data bar options +data bar options;conditional formatting + +

Databar More Options

+

Entry Values

+

Minimum:

Set the minimum value for which the data bar does not start filling. +

Maximum:

Set the maximum value for which the data bar gets completely filled. + The options for setting the minimum and maximum values are: + Automatic: Automatically sets the minimum and maximum value based on the values in the data set. + + + Minimum: Automatically sets the minimum value in the data set as minimum. + + + Maximum: Automatically sets the maximum value in the data set for maximum. + + + Percentile: Set the minimum and maximum as percentile value. + + + Value: Set the minimum and maximum as a specific value. + + + Formula: Set the minimum and maximum as a formula. + + +

Bar Colors

+

Positive:

Set the color for positive values. It is set to blue be default. +

Negative:

Set the color for negative values. It is set to red by default. +

Fill:

Choose between color and gradient for the fill. +

Axis

+

Position of vertical axis:

Set the position of vertical axis in the cell. + + + Automatic: Set the axis automatically + + + Middle: Set the vertical position to be in the middle of the cell. + + + None: Set the data bar to have no visible vertical axis + + +

Color of vertical axis:

Choose the color of the vertical axis. +

Bar Lengths

+

Minimum bar length (%):

Set the minimum length of the data bar in percentage with respect to the cell length. +

Maximum bar length (%):

Set the maximum length of the data bar in percentage with respect to the cell length. +

Display bar only

+ Only databar is shown. Value becomes hidden. + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/ex_data_stat_func.xhp b/helpcontent2/source/text/scalc/01/ex_data_stat_func.xhp new file mode 100644 index 000000000..7981e9191 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/ex_data_stat_func.xhp @@ -0,0 +1,162 @@ + + + + + + + Examples Dataset for Statistical Functions + /text/scalc/01/ex_data_stat_func.xhp + + + + +
+ +Consider the following table + + + + + + A + + + B + + + C + + + + + 1 + + + Product Name + + + Sales + + + Revenue + + + + + 2 + + + pencil + + + 20 + + + 65 + + + + + 3 + + + pen + + + 35 + + + 85 + + + + + 4 + + + notebook + + + 20 + + + 190 + + + + + 5 + + + book + + + 17 + + + 180 + + + + + 6 + + + pencil-case + + + not + + + not + + +
+In all examples below, ranges for calculation contain the row #6, which is ignored because it contains text. +
+Func_Range; Range1; Criterion[; Range2; Criterion2][; … ; [Range127; Criterion127]] +
+ The logical relation between criteria can be defined as logical AND (conjunction). In other words, if and only if all given criteria are met, a value from the corresponding cell of the given Func_Range is taken into calculation. +
+
+ Func_Range and Range1, Range2... must have the same size, otherwise the function returns err:502 - Invalid argument. +
+
+ Range1 – required argument. It is a range of cells, a name of a named range, or a label of a column or a row, to which the corresponding criterion is to be applied. +
+ Criterion: A criterion is a single cell Reference, Number or Text. It is used in comparisons with cell contents. + A reference to an empty cell is interpreted as the numeric value 0. + A matching expression can be: + + + A Number or Logical value. A matching cell content equals the Number or Logical value. + + + A value beginning with a comparator (<, <=, =, >, >=, <>). + For =, if the value is empty it matches empty cells. + For <>, if the value is empty it matches non-empty cells. + For <>, if the value is not empty it matches any cell content except the value, including empty cells. + Note: "=0" does not match empty cells. + For = and <>, if the value is not empty and can not be interpreted as a Number type or one of its subtypes and the property Search criteria = and <> must apply to whole cells is checked, comparison is against the entire cell contents, if unchecked, comparison is against any subpart of the field that matches the criteria. For = and <>, if the value is not empty and can not be interpreted as a Number type or one of its subtypes applies. + + + Other Text value. If the property Search criteria = and <> must apply to whole cells is true, the comparison is against the entire cell contents, if false, comparison is against any subpart of the field that matches the criteria. The expression can contain text, numbers, regular expressions or wildcards (if enabled in calculation options). + + +
+ Range2 – Optional. Range2 and all the following mean the same as Range1. + Criterion2 – Optional. Criterion2 and all the following mean the same as Criterion. +
+
+ The function can have up to 255 arguments, meaning that you can specify 127 criteria ranges and criteria for them. + If a cell contains TRUE, it is treated as 1, if a cell contains FALSE – as 0 (zero). +
+ + diff --git a/helpcontent2/source/text/scalc/01/exponsmooth_embd.xhp b/helpcontent2/source/text/scalc/01/exponsmooth_embd.xhp new file mode 100644 index 000000000..8fe3927cd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/exponsmooth_embd.xhp @@ -0,0 +1,386 @@ + + + + + + + embedded text for exponential smoothing + /text/scalc/01/exponsmooth_embd.xhp + + + +
+ Exponential Smoothing is a method to smooth real values in time series in order to forecast probable future values. + +Exponential Triple Smoothing (ETS) is a set of algorithms in which both trend and periodical (seasonal) influences are processed. Exponential Double Smoothing (EDS) is an algorithm like ETS, but without the periodical influences. EDS produces linear forecasts. + +See the Wikipedia on Exponential smoothing algorithms for more information. +
+ +
+target (mandatory): A date, time or numeric single value or range. The data point/range for which to calculate a forecast. +
+ +
+values (mandatory): A numeric array or range. values are the historical values, for which you want to forecast the next points. +
+ +
+timeline (mandatory): A numeric array or range. The timeline (x-value) range for the historical values. +The timeline does not have to be sorted, the functions will sort it for calculations.
The timeline values must have a consistent step between them.
If a constant step cannot be identified in the sorted timeline, the functions will return the #NUM! error.
If the ranges of both the timeline and the historical values are not the same size, the functions will return the #N/A error.
If the timeline contains fewer than 2 data periods, the functions will return the #VALUE! error. +
+ +
+data_completion (optional): a logical value TRUE or FALSE, a numeric 1 or 0, default is 1 (TRUE). A value of 0 (FALSE) will add missing data points with zero as historical value. A value of 1 (TRUE) will add missing data points by interpolating between the neighboring data points. +Although the time line requires a constant step between data points, the function support up to 30% missing data points, and will add these data points. +
+ +
+aggregation (optional): A numeric value from 1 to 7, with default 1. The aggregation parameter indicates which method will be used to aggregate identical time values: + + + + + Aggregation + + + Function + + + + + 1 + + + AVERAGE + + + + + 2 + + + COUNT + + + + + 3 + + + COUNTA + + + + + 4 + + + MAX + + + + + 5 + + + MEDIAN + + + + + 6 + + + MIN + + + + + 7 + + + SUM + + +
+ +Although the time line requires a constant step between data points, the functions will aggregate multiple points which have the same time stamp. +
+ +
+stat_type (mandatory): A numerical value from 1 to 9. A value indicating which statistic will be returned for the given values and x-range. +The following statistics can be returned: + + + + + stat_type + + + Statistics + + + + + 1 + + + Alpha smoothing parameter of ETS algorithm (base) + + + + + 2 + + + Gamma smoothing parameter of ETS algorithm (trend) + + + + + 3 + + + Beta smoothing parameter of ETS algorithm (periodic deviation) + + + + + 4 + + + Mean absolute scaled error (MASE) - a measure of the accuracy of forecasts. + + + + + 5 + + + Symmetric mean absolute percentage error (SMAPE) - an accuracy measure based on percentage errors. + + + + + 6 + + + Mean absolute error (MAE) – a measure of the accuracy of forecasts. + + + + + 7 + + + Root mean squared error (RMSE) - a measure of the differences between predicted and observed values. + + + + + 8 + + + Step size detected time line (x-range). When a stepsize in months/quarters/years is detected, the stepsize is in months, otherwise the stepsize is in days in case of date(time) timeline and numeric in other cases. + + + + + 9 + + + Number of samples in period – this is the same as argument period_length, or the calculated number in case of argument period_length being 1. + + +
+ +
+ +
+confidence_level (mandatory): A numeric value between 0 and 1 (exclusive), default is 0.95. A value indicating a confidence level for the calculated prediction interval. +With values <= 0 or >= 1, the functions will return the #NUM! Error. +
+ +
+period_length (optional): A numeric value >= 0, the default is 1. A positive integer indicating the number of samples in a period. +A value of 1 indicates that Calc is to determine the number of samples in a period automatically.
A value of 0 indicates no periodic effects, a forecast is calculated with EDS algorithms.
For all other positive values, forecasts are calculated with ETS algorithms.
For values that not being a positive whole number, the functions will return the #NUM! Error. +
+ +
+forecast = basevalue + trend * ∆x + periodical_aberration. +
+ +
+forecast = ( basevalue + trend * ∆x ) * periodical_aberration. +
+ +
+ + The table below contains a timeline and its associated values: + + + + + + + A + + + B + + + + + 1 + + + Timeline + + + Values + + + + + 2 + + + 01/2013 + + + 112 + + + + + 3 + + + 02/2013 + + + 118 + + + + + 4 + + + 03/2013 + + + 132 + + + + + 5 + + + 04/2013 + + + 100 + + + + + 6 + + + 05/2013 + + + 121 + + + + + 7 + + + 06/2013 + + + 135 + + + + + 8 + + + 07/2013 + + + 148 + + + + + 9 + + + 08/2013 + + + 148 + + + + + 10 + + + 09/2013 + + + 136 + + + + + 11 + + + 10/2013 + + + 119 + + + + + 12 + + + 11/2013 + + + 104 + + + + + 13 + + + 12/2013 + + + 118 + + +
+
+ + + diff --git a/helpcontent2/source/text/scalc/01/format_graphic.xhp b/helpcontent2/source/text/scalc/01/format_graphic.xhp new file mode 100644 index 000000000..01f17a2d7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/format_graphic.xhp @@ -0,0 +1,46 @@ + + + + + + + + +Graphic +/text/scalc/01/format_graphic.xhp + + +Format Graphic menu in Calc + + + +
+ +Graphic +Opens a submenu to edit the properties of the selected object. +
+ + + +Define Text Attributes +Sets the layout and anchoring properties for text in the selected drawing or text object. +Points +Switches Edit Points mode for an inserted freeform line on and off. + + diff --git a/helpcontent2/source/text/scalc/01/formula2value.xhp b/helpcontent2/source/text/scalc/01/formula2value.xhp new file mode 100644 index 000000000..3b06a1c7d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/formula2value.xhp @@ -0,0 +1,36 @@ + + + + + + + Formula to values + /text/scalc/01/formula2value.xhp + + + + + +convert;formula to values +replace formula with values +recalculate;formula to values +formula to values;convert +formula to values;recalculate + +
+

Formula to value

+ Replaces the formula cell with value calculated by the formula. The formula is lost. +
+
+ +
+ Use this command to convert formula cells into data cells. The converted cells contents becomes static and will not be recalculated. + + diff --git a/helpcontent2/source/text/scalc/01/ful_func.xhp b/helpcontent2/source/text/scalc/01/ful_func.xhp new file mode 100644 index 000000000..1a1f2a3a5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/ful_func.xhp @@ -0,0 +1,93 @@ + + + + + + Frequently Used Lexemes + /text/scalc/01/ful_func.xhp + + + + Title in descriptions of functions +
+

Syntax

+
+
+

Examples

+
+
+

Returns

+
+ + Yes or No paragraphs to be used in description tables +
+ Yes +
+
+ No +
+ + Notes for functions + + A complex number is a string expression resulting in the form "a+bi" or "a+bj", where a and b are numbers. + + + If the complex number is actually a real number (b=0), then it can be either a string expression or a number value. + + + Warnings for functions + + The function always returns a string representing a complex number. + + + If the result is a complex number with one of its parts (a or b) equal to zero, that part is not displayed. + + + Other paragraphs + + The imaginary part is equal to zero, so it is not displayed in the result. + +
+ The result is presented in the string format and has the character "i" or "j" as an imaginary unit. +
+ + 255 arguments + String 1 [; String 2 [; … [; String 255]]] +
+ String 1, String 2, … , String 255 are strings, references to cells or to cell ranges of strings. +
+ Integer 1 [; Integer 2 [; … [; Integer 255]]] +
+ Integer 1, Integer 2, … , Integer 255 are integers, references to cells or to cell ranges of integers. +
+ Number 1 [; Number 2 [; … [; Number 254]]] +
+ Number 1, Number 2, … , Number 254 are numbers, references to cells or to cell ranges of numbers. +
+ Number 1 [; Number 2 [; … [; Number 255]]] +
+ Number 1, Number 2, … , Number 255 are numbers, references to cells or to cell ranges of numbers. +
+ Logical 1 [; Logical 2 [; … [; Logical 255]]] +
+ Logical 1, Logical 2, … , Logical 255 are boolean values, references to cells or to cell ranges of logical values. +
+ Complex 1 [; Complex 2 [; … [; Complex 255]]] +
+ Complex 1, Complex 2, … ,Complex 255 are complex numbers, references to cells or to cell ranges of complex numbers. Complex numbers are entered in the form "x+yi" or "x+yj". +
+ Reference 1 [; Reference 2 [; … [; Reference 255]]] +
+ Reference 1, Reference 2, … ,Reference 255 are references to cells. +
+
+ This function is always recalculated whenever a recalculation occurs. +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_aggregate.xhp b/helpcontent2/source/text/scalc/01/func_aggregate.xhp new file mode 100644 index 000000000..c914b0073 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_aggregate.xhp @@ -0,0 +1,441 @@ + + + + + + + AGGREGATE function + /text/scalc/01/func_aggregate.xhp + + + +
+ + + AGGREGATE function + +

AGGREGATE function

+This function returns an aggregate result of the calculations in the range. You can use different aggregate functions listed below. The Aggregate function enables you to omit hidden rows, errors, SUBTOTAL and other AGGREGATE function results in the calculation. +
+AGGREGATE function is applied to vertical ranges of data with activated AutoFilter. If AutoFilter is not activated, automatic recalculation of the function result does not work for newly hidden rows. It is not supposed to work with horizontal ranges, however it can be applied to them as well, but with limitations. In particular, the AGGREGATE function applied to a horizontal data range does not recognize hiding columns, however correctly omits errors and results of SUBTOTAL and other AGGREGATE functions embedded into the row. + +AGGREGATE(Function; Option; Number 1[; Number 2][; ... ;[Number 253]]) +or +AGGREGATE(Function; Option; Array[; k]) + +Function – obligatory argument. A function index or a reference to a cell with value from 1 to 19, in accordance with the following table. + + + + + Function index + + + Function applied + + + + + 1 + + + AVERAGE + + + + + 2 + + + COUNT + + + + + 3 + + + COUNTA + + + + + 4 + + + MAX + + + + + 5 + + + MIN + + + + + 6 + + + PRODUCT + + + + + 7 + + + STDEV.S + + + + + 8 + + + STDEV.P + + + + + 9 + + + SUM + + + + + 10 + + + VAR.S + + + + + 11 + + + VAR.P + + + + + 12 + + + MEDIAN + + + + + 13 + + + MODE.SNGL + + + + + 14 + + + LARGE + + + + + 15 + + + SMALL + + + + + 16 + + + PERCENTILE.INC + + + + + 17 + + + QUARTILE.INC + + + + + 18 + + + PERCENTILE.EXC + + + + + 19 + + + QUARTILE.EXC + + +
+ +Option – obligatory argument. An option index or reference to a cell with value from 0 to 7 determines what to ignore in the range for the function. + + + + + Option index + + + Option applied + + + + + 0 + + + Ignore only nested SUBTOTAL and AGGREGATE functions + + + + + 1 + + + Ignore only hidden rows, nested SUBTOTAL and AGGREGATE functions + + + + + 2 + + + Ignore only errors, nested SUBTOTAL and AGGREGATE functions + + + + + 3 + + + Ignore hidden rows, errors, nested SUBTOTAL and AGGREGATE functions + + + + + 4 + + + Ignore nothing + + + + + 5 + + + Ignore only hidden rows + + + + + 6 + + + Ignore only errors + + + + + 7 + + + Ignore only hidden rows and errors + + +
+ +Number1 – required argument. The first numeric argument (if the range is set by a list of values inside the function) or a reference to a cell that contains it. +Number2, 3, ... – optional. A numeric argument or a reference to a cell (up to 253 arguments), for which you need the aggregate value. +Array – required argument. The array can be specified by the boundaries of the range, the name of the named range or the column label. +For using column labels “Automatically find columns and rows labels” function needs to be enabled. +k – required argument for the following functions: LARGE, SMALL, PERCENTILE.INC, QUARTILE.INC, PERCENTILE.EXC, QUARTILE.EXC. It is a numeric argument, which must correspond to the second argument of these functions. + + + + + + + + + A + + + B + + + C + + + + + 1 + + + ColumnOne + + + ColumnTwo + + + ColumnThree + + + + + 2 + + + 34 + + + 11 + + + 12 + + + + + 3 + + + 10 + + + 56 + + + 35 + + + + + 4 + + + #DIV/0! + + + 5 + + + 3 + + + + + 5 + + + 20 + + + 8 + + + 1 + + + + + 6 + + + 0 + + + 8 + + + 9 + + + + + 7 + + + #VALUE! + + + 20 + + + 21 + + + + + 8 + + + 5 + + + 7 + + + 8 + + + + + 9 + + + 14 + + + 0 + + + 5 + + +
+ +=AGGREGATE(4;2;A2:A9)
Returns maximum value for the range A2:A9 = 34, whereas =MAX(A2:A9) returns the error Err:511. +=AGGREGATE(9;5;A5:C5)
Returns sum for the range A5:C5 = 29, even if some of the columns are hidden. +=AGGREGATE(9;5;B2:B9)
Returns sum of the column B = 115. If any row is hidden, the function omit its value, for example if the 7th row is hidden, the function returns 95. +If you need to apply the function with a 3D range, this example shows how to do it. +=AGGREGATE(13;3;Sheet1.B2:B9:Sheet3.B2:B9)
The function returns mode of the values of second columns through sheets 1:3 (that have the same data) = 8. +You can use reference to a cell or a range for every argument in the formula. The following example shows how it works. Besides, it shows that you can use column labels to specify an array. +=AGGREGATE(E3;E5;'ColumnOne')
If E3 = 13 and E5 = 5, the function returns mode of the first column = 10. + + + +COM.MICROSOFT.AGGREGATE +
+AVERAGE, COUNT, COUNTA, MAX, MIN, PRODUCT, STDEV.S, STDEV.P, SUM, VAR.S, VAR.P, MEDIAN, MODE.SNGL, LARGE, SMALL, PERCENTILE.INC , QUARTILE.INC, PERCENTILE.EXC, QUARTILE.EXC +Automatically find column and row labels +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_arabic.xhp b/helpcontent2/source/text/scalc/01/func_arabic.xhp new file mode 100644 index 000000000..b827428e8 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_arabic.xhp @@ -0,0 +1,42 @@ + + + + + + + ARABIC Function + /text/scalc/01/func_arabic.xhp + + + +
+ + + ARABIC function + text functions;convert roman numbers + +

ARABIC

+ Returns the numeric value corresponding to a Roman number expressed as text. +
+ The largest Roman number that can be converted is MMMCMXCIX (or one of its simplified versions), which is equivalent to 3999. + + ARABIC(Text) + Text: text representing a Roman number. + + =ARABIC("MXIV") returns the numeric value 1014. + =ARABIC("MMII") returns the numeric value 2002. + =ARABIC("") returns 0. + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_asc.xhp b/helpcontent2/source/text/scalc/01/func_asc.xhp new file mode 100644 index 000000000..c828efb66 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_asc.xhp @@ -0,0 +1,42 @@ + + + + + + + ASC Function + /text/scalc/01/func_asc.xhp + + + +
+ + + ASC function + text functions;katakana characters + +

ASC

+ Converts double-byte (full-width) characters to single-byte (half-width) ASCII and katakana characters. +
+ See https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions for a conversion table. + + ASC(Text) + Text: the text string that contains characters to be converted. + Applying the ASC function to a string composed of single-byte characters will return the input string without any modifications. + + =ASC("LibreOffice") returns the string "LibreOffice". No modifications were made because all characters are single-byte characters. + =ASC("ライト") returns the string "ﾗｲﾄ", which is composed of single-byte characters. + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_averageif.xhp b/helpcontent2/source/text/scalc/01/func_averageif.xhp new file mode 100644 index 000000000..5d41712cc --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_averageif.xhp @@ -0,0 +1,84 @@ + + + + + + + AVERAGEIF function + /text/scalc/01/func_averageif.xhp + + + + +
+ + + AVERAGEIF function + arithmetic mean;satisfying condition + +

AVERAGEIF function

+Returns the arithmetic mean of all cells in a range that satisfy a given condition. The AVERAGEIF function sums up all the results that match the logical test and divides this sum by the quantity of selected values. +
+ + +AVERAGEIF(Range; Criterion [; Average_Range ]) +Range – required argument. An array, a name of named range or a label of a column or a row containing numbers for averaging or numbers or text for the condition. + + +Average_Range – optional. It is a range of values for calculating the mean. +If the Average_Range is not specified, Range is used for both, the calculation of the mean and the search according to the condition. If Average_Range is specified, the Range is used only for the condition test, while Average_Range is used for the average calculation. + +If a cell in a range of values for calculating the mean is empty or contains text, function AVERAGEIF ignores this cell.
+If the whole range is empty, contains only text or all values of the range do not satisfy the condition (or any combination of those), the function returns the #DIV/0! error. + +

Simple usage

+=AVERAGEIF(B2:B6;"<35") +Calculates the average for values of the range B2:B6 that are less than 35. Returns 19, because the second row does not participate in the calculation. +=AVERAGEIF(B2:B6;"<"&MAX(B2:B6)) +Calculates the average for values of the same range that are less than the maximum value of this range. Returns 19, because the largest value (the second row) does not participate in the calculation. +=AVERAGEIF(B2:B6;">"&SMALL(B2:B6;1)) +Calculates the average for values of the same range that are greater than the first smallest value of this range. Returns 25, because the first smallest value (the fourth row) does not participate in the calculation. +

Using the Average_Range

+=AVERAGEIF(B2:B6;"<35";C2:C6) +The function searches what values are less than 35 in the B2:B6 range, and calculates the average of corresponding values from the C2:C6 range. Returns 145, because the second row does not participate in the calculation. +=AVERAGEIF(B2:B6;">"&MIN(B2:B6);C2:C6) +The function searches what values from the range B2:B6 are greater than the least value in the B2:B6 range, and calculates the average of corresponding values from the C2:C6 range. Returns 113.3, because the fourth row (where there is the least value in the range B2:B6) does not participate in the calculation. +=AVERAGEIF(B2:B6;"<"&LARGE(B2:B6;2);C2:C6) +The function searches what values from the range B2:B6 are less than the second large value in the B2:B6 range, and calculates the average of corresponding values from the C2:C6 range. Returns 180, because only the fourth row participates in the calculation. +

Using regular expressions

+=AVERAGEIF(A2:A6;"pen";B2:B6) +The function searches what cells from the range A2:A6 contain only the word “pen”, and calculates the average of corresponding values from the B2:B6 range. Returns 35, because only the second row participates in the calculation. The search is performed in the A2:A6 range, but the values are returned from the B2:B6 range. +=AVERAGEIF(A2:A6;"pen.*";B2:B6) +The function searches what cells from the range A2:A6 begin with “pen” ending with any quantity of other characters, and calculates the average of corresponding values from the B2:B6 range. Returns 27.5, because now also “pencil” satisfies the condition, and both, first and second rows participate in the calculation. +=AVERAGEIF(A2:A6;".*book.*";B2:B6) +The function searches what cells from the range A2:A6 contain “book” starting and ending with any quantity of other characters, and calculates the average of corresponding values from the B2:B6 range. Returns 18.5, because only third and fourth rows participate in the calculation. +

Reference to a cell as a criterion

+If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of AVERAGEIF function. +=AVERAGEIF(A2:A6;".*"&E2&".*";B2:B6) +The function searches what cells from the range A2:A6 contain a combination of characters specified in E2 starting and ending with any quantity of other characters, and calculates the average of corresponding values from the B2:B6 range. If E2 = book, the function returns 18.5. +=AVERAGEIF(B2:B6;"<"&E2;C2:C6) +The function searches what cells from the range B2:B6 are less than the value specified in E2, and calculates the average of corresponding values from the C2:C6 range. If E2 = 35, the function returns 145. +
+ + , + , + + + + , + , + , + , + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_averageifs.xhp b/helpcontent2/source/text/scalc/01/func_averageifs.xhp new file mode 100644 index 000000000..e94dc7bea --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_averageifs.xhp @@ -0,0 +1,74 @@ + + + + + + + AVERAGEIFS function + /text/scalc/01/func_averageifs.xhp + + + + +
+ + + AVERAGEIFS function + arithmetic mean;satisfying conditions + +

AVERAGEIFS function

+Returns the arithmetic mean of all cells in a range that satisfy given multiple criteria. The AVERAGEIFS function sums up all the results that match the logical tests and divides this sum by the quantity of selected values. +
+ + +AVERAGEIFS() +Func_range – required argument. It is a range of cells, a name of a named range or a label of a column or a row containing values for calculating the mean. + + + + + + + + + +

Simple usage

+=AVERAGEIFS(B2:B6;B2:B6;">=20") +Calculates the average for values of the range B2:B6 that are greater than or equal to 20. Returns 25, because the fifth row does not meet the criterion. +=AVERAGEIFS(C2:C6;B2:B6;">=20";C2:C6;">70") +Calculates the average for values of the range C2:C6 that are greater than 70 and correspond to cells of B2:B6 with values greater than or equal to 20. Returns 137.5, because the second and fifth rows do not meet at least one criterion. +

Using regular expressions and nested functions

+=AVERAGEIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6)) +Calculates the average for values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 127.5, because the third and fifth rows do not meet at least one criterion. +=AVERAGEIFS(C2:C6;A2:A6;"pen.*";B2:B6;"<"&MAX(B2:B6)) +Calculates the average for values of the range C2:C6 that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range except its maximum. Returns 65, because only second row meets all criteria. +

Reference to a cell as a criterion

+If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of AVERAGEIFS function. For example, the above function can be rewritten as follows: +=AVERAGEIFS(C2:C6;A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6)) +If E2 = pen, the function returns 65, because the link to the cell is substituted with its content. + +
+ + , + , + , + + + + , + , + , + , + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_ceiling.xhp b/helpcontent2/source/text/scalc/01/func_ceiling.xhp new file mode 100644 index 000000000..e671f6093 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_ceiling.xhp @@ -0,0 +1,150 @@ + + + + + + Ceiling functions + /text/scalc/01/func_ceiling.xhp + + + +

Ceiling functions

+
+ +CEILING function +rounding;up to multiples of significance + + mw added one entry + +

CEILING

+ Rounds a number to the nearest multiple of a significance value. + For a positive number and a positive significance value, the function rounds up (away from zero). For a negative number and a negative significance value, the direction of rounding is determined by the value of a mode parameter. The function returns an error if the number and significance values have opposite signs. + If the spreadsheet is exported to Microsoft Excel, the CEILING function is exported as the equivalent CEILING.MATH function that has existed since Excel 2013. If you plan to use the spreadsheet with earlier Excel versions, use either CEILING.PRECISE that has existed since Excel 2010, or CEILING.XCL that is exported as the CEILING function compatible with all Excel versions. + + CEILING(Number [; Significance [; Mode]]) +
+ Number is the number that is to be rounded, or a reference to a cell containing the number. +
+ Significance (optional) is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. It defaults to +1 or -1 depending on the sign of Number. + Mode (optional) is a number, or a reference to a cell containing a number. The function only uses Mode if both Number and Significance are negative. Then if Mode is given and not equal to zero, numbers are rounded down (away from zero); if Mode is equal to zero or not given, negative numbers are rounded up (towards zero). + + =CEILING(3.45) returns 4. + =CEILING(3.45; 3) returns 6. + =CEILING(-1.234) returns -1. + =CEILING(-45.67; -2; 0) returns -44. + =CEILING(-45.67; -2; 1) returns -46. + see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+ +
+ +CEILING.PRECISE function +rounding;up to multiples of significance + + mw added one entry + +

CEILING.PRECISE

+ Rounds a number up to the nearest multiple of a significance value. + For a positive number the function rounds up (away from zero). For a negative number, the function rounds up (towards zero). The sign of the significance value is ignored. + This function calculates identical results to the ISO.CEILING function. + + CEILING.PRECISE(Number [; Significance]) + + Significance (optional) is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. It defaults to 1. + + =CEILING.PRECISE(3.45) returns 4. + =CEILING.PRECISE(-45.67; 2) returns -44. + + + + COM.MICROSOFT.CEILING.PRECISE + see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+ +
+ +CEILING.MATH function + + +

CEILING.MATH

+ Rounds a number to the nearest multiple of a significance value. + For a positive number the function rounds up (away from zero). For a negative number, the direction of rounding is determined by the value of a mode parameter. The sign of the significance value is ignored. + This function exists for interoperability with Microsoft Excel 2013 or newer. + + CEILING.MATH(Number [; Significance [; Mode]]) + + Significance (optional) is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. It defaults to 1. + Mode (optional) is a number, or a reference to a cell containing a number. If Mode is given and not equal to zero, a negative Number is rounded down (away from zero). If Mode is equal to zero or is not given, a negative Number is rounded up (towards zero). + + =CEILING.MATH(3.45) returns 4. + =CEILING.MATH(3.45; -3) returns 6. + =CEILING.MATH(-1.234) returns -1. + =CEILING.MATH(-45.67; -2; 0) returns -44. + =CEILING.MATH(-45.67; +2; 1) returns -46. + + + + COM.MICROSOFT.CEILING.MATH +
+
+ +CEILING.XCL function + + +

CEILING.XCL

+ Rounds a number to the nearest multiple of a significance value. + For a positive number and a positive significance value, the function rounds up (away from zero). For a negative number and a positive significance value, the function rounds up (towards zero). For a negative number and a negative significance value, the function rounds down (away from zero). The function returns an error if the number is positive and the significance value is negative. + This function exists for interoperability with Microsoft Excel 2007 or older. If a Calc spreadsheet is exported to Microsoft Excel, references to Calc’s CEILING.XCL function are exported as references to Excel’s CEILING function, which is compatible with all Excel versions. If a Microsoft Excel spreadsheet is imported into Calc, references to Excel’s CEILING function are imported as references to Calc’s CEILING.XCL function. + + CEILING.XCL(Number; Significance) + + Significance is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. + + =CEILING.XCL(3.45,2) returns 4. + =CEILING.XCL(-45.67; 2) returns -44. + =CEILING.XCL(-45.67; -2) returns -46. + + + + COM.MICROSOFT.CEILING +
+
+ +ISO.CEILING function +rounding;up to multiples of significance + + mw added one entry + + +

ISO.CEILING

+ Rounds a number up to the nearest multiple of a significance value. + For a positive number the function rounds up (away from zero). For a negative number, the function rounds up (towards zero). The sign of the significance value is ignored. + This function calculates identical results to the CEILING.PRECISE function. + + ISO.CEILING(Number [; Significance]) + + Significance (optional) is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. It defaults to 1. + + =ISO.CEILING(3.45) returns 4. + =ISO.CEILING(-45.67; 2) returns -44. + + + + COM.MICROSOFT.ISO.CEILING + see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+
+ + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_color.xhp b/helpcontent2/source/text/scalc/01/func_color.xhp new file mode 100644 index 000000000..26b6b6722 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_color.xhp @@ -0,0 +1,53 @@ + + + + + + + COLOR function + /text/scalc/01/func_color.xhp + + + +
+ + + colors;numerical values + colors;calculating in spreadsheets + COLOR function + +

COLOR

+ Return a numeric value calculated by a combination of three colors (red, green and blue) and the alpha channel, in the RGBA color system. The result depends on the color system used by your computer. +
+ + COLOR(Red; Green; Blue [; Alpha]) + Red, Green and Blue – required arguments. The value for the red, green and blue components of the color. The values must be between 0 and 255. Zero means no color component and 255 means full color component. + Alpha – optional argument. The value for the alpha channel or alpha composite. Alpha is a integer value between 0 and 255. The value of zero for alpha means the color is fully transparent, whereas a value of 255 in the alpha channel gives a fully opaque color. + + COLOR(255;255;255;1) returns 33554431 + COLOR(0;0;255;0) returns 255 + COLOR(0;0;255;255) returns 4278190335 + COLOR(0;0;400;0) returns Err:502 (Invalid argument) because the blue value is greater than 255. + + + + + ORG.LIBREOFFICE.COLOR + + diff --git a/helpcontent2/source/text/scalc/01/func_concat.xhp b/helpcontent2/source/text/scalc/01/func_concat.xhp new file mode 100644 index 000000000..5063ac92a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_concat.xhp @@ -0,0 +1,43 @@ + + + + + + + CONCAT function + /text/scalc/01/func_concat.xhp + + + +
+ + + CONCAT function + +

CONCAT

+ Concatenates one or more strings +
+ CONCAT is an enhancement of CONCATENATE, as CONCAT also accepts ranges as arguments, like B2:E5, K:K or K:M. + When ranges are used, the cells are traversed row by row (from top to bottom) to concatenate. + + CONCAT( ) + + + =CONCAT("Hello ", A1:C3) concatenates the string "Hello" with all strings in range A1:C3. + + + + COM.MICROSOFT.CONCAT +
+ + CONCATENATE +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_convert.xhp b/helpcontent2/source/text/scalc/01/func_convert.xhp new file mode 100644 index 000000000..c422ba5bd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_convert.xhp @@ -0,0 +1,1744 @@ + + + + + + CONVERT function + /text/scalc/01/func_convert.xhp + + + +
+ + + CONVERT function + +

+ + CONVERT + function +

+ + Converts a value from one unit of measurement to the corresponding value in another unit of measurement. Enter the units of measurement directly as text in quotation marks or as a reference. The units of measurement specified through the arguments must match the supported unit symbols, which are case-sensitive. For example, the symbol for the unit "newton" is the uppercase "N". + The measurement units recognized by CONVERT fall into 13 groups, which are listed below. CONVERT will perform conversions between any two units within one group but reject any request to convert between units in different groups. + You can also add binary and decimal prefixes to units of measurement that support them. The list of all prefixes and their corresponding multipliers are shown below. +
+ This function may not be compatible with other spreadsheet software. + + + + CONVERT(Number; FromUnit; ToUnit) + + + Number is the number to be converted. + + + FromUnit is the unit from which conversion is taking place. + + + ToUnit is the unit to which conversion is taking place. Both units must be of the same type. + + If FromUnit and ToUnit are not valid units from the same group, then CONVERT reports an invalid argument error (Err:502). + + + + =CONVERT(-10; "C"; "F") + Here the function converts -10 degrees Celsius to degrees Fahrenheit, returning the value 14. There is not a simple multiplicative relationship between temperature units, as different reference points are used. Hence, as in this case, an input negative number may be converted to a positive value. + + =CONVERT(3.5; "mi"; "yd") + Here the function converts 3.5 international miles to yards, returning the value 6160. Both units are in the Length and distance group. + + =CONVERT(256; "Gibit"; "Mibyte") + Here the function converts 256 gigibits to mebibytes, returning the value 32768. Both units (bit and byte) are in the Information group and support binary prefixes. + + =CONVERT(1; "dyn"; "e") + Here the function returns an invalid argument error (Err:502) because the two units (dyne and erg) are in different groups (Force and Energy respectively). + +
+

Units of measurement

+
+ Below are the unit measurement groups supported by the CONVERT function. Beware that conversions can only happen between units that belong to the same group. + The column Prefix indicates whether or not a given unit of measurement supports prefixes. + +

Area

+ Some measurement units have more than one accepted symbol. The accepted unit symbols are separated by semicolons in the Unit symbol column. + + + + Unit symbol + + + Description + + + Prefix + + + + + "ang2" ; "ang^2" + + + Square angstrom + + + + + + + + "ar" + + + Are + + + + + + + + "ft2" ; "ft^2" + + + Square foot + + + + + + + + "ha" + + + Hectare + + + + + + + + "in2" ; "in^2" + + + Square inch + + + + + + + + "ly2" ; "ly^2" + + + Square light-year + + + + + + + + "m2" ; "m^2" + + + Square meter + + + + + + + + "mi2" ; "mi^2" + + + Square international mile + + + + + + + + "Morgen" + + + Morgen + + + + + + + + "Nmi2" ; "Nmi^2" + + + Square nautical mile + + + + + + + + "Pica2" ; "Pica^2" ; "picapt2" ; "picapt^2" + + + Square pica point + + + + + + + + "pica2" ; "pica^2" + + + Square pica + + + + + + + + "uk_acre" ; "acre" + + + International acre + + + + + + + + "us_acre" + + + US survey acre + + + + + + + + "yd2" ; "yd^2" + + + Square yard + + + + + +
+ +

Energy

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "BTU" ; "btu" + + + British thermal unit + + + + + + + + "c" + + + Thermochemical calorie + + + + + + + + "cal" + + + International Steam Table calorie + + + + + + + + "e" + + + erg + + + + + + + + "eV" ; "ev" + + + Electron volt + + + + + + + + "flb" + + + Foot-pound + + + + + + + + "HPh" ; "hh" + + + Horsepower-hour + + + + + + + + "J" + + + Joule + + + + + + + + "Wh" ; "wh" + + + Watt-hour + + + + + +
+ +

Flux density

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "ga" + + + Gauss + + + + + + + + "T" + + + Tesla + + + + + +
+ +

Force

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "dyn" ; "dy" + + + Dyne + + + + + + + + "N" + + + Newton + + + + + + + + "lbf" + + + Pound-force + + + + + + + + "pond" + + + Pond + + + + + +
+ +

Information

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "bit" + + + Bit + + + + + + + + "byte" + + + Byte + + + + + +
+ +

Length and distance

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "ang" + + + Angstrom + + + + + + + + "ell" + + + Ell + + + + + + + + "ft" + + + Foot + + + + + + + + "in" + + + Inch + + + + + + + + "ly" ; "lightyear" + + + Light-year + + + + + + + + "m" + + + Meter + + + + + + + + "mi" + + + International mile + + + + + + + + "Nmi" + + + Nautical mile + + + + + + + + "parsec" ; "pc" + + + Parsec + + + + + + + + "Pica" ; "picapt" + + + Pica point + + + + + + + + "pica" + + + Pica + + + + + + + + "survey_mi" + + + US survey mile + + + + + + + + "yd" + + + Yard + + + + + +
+ +

Mass and weight

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "cwt" ; "shweight" + + + Short hundredweight + + + + + + + + "g" + + + Gram + + + + + + + + "grain" + + + Grain + + + + + + + + "lbm" + + + Pound + + + + + + + + "ozm" + + + Ounce + + + + + + + + "pweight" + + + Pennyweight + + + + + + + + "sg" + + + Slug + + + + + + + + "stone" + + + Stone + + + + + + + + "ton" + + + Short ton + + + + + + + + "u" + + + Unified atomic mass unit + + + + + + + + "uk_cwt" ; "lcwt" ; "hweight" + + + Long hundredweight + + + + + + + + "uk_ton" ; "LTON" ; "brton" + + + Long ton + + + + + +
+ +

Power

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "HP" ; "h" + + + Mechanical horsepower + + + + + + + + "PS" + + + Pferdestärke or metric horsepower + + + + + + + + "W" ; "w" + + + Watt + + + + + +
+ +

Pressure

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "atm" ; ("at")(1) + + + Standard atmosphere + + + + + + + + "mmHg" + + + Millimeter of mercury + + + + + + + + "Pa" + + + Pascal + + + + + + + + "psi" + + + Pound per square inch + + + + + + + + "Torr" + + + Torr + + + + + +
+ 1 - The "at" unit is deprecated. Use "atm" instead. + +

Speed

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "admkn" + + + Admiralty knot + + + + + + + + "kn" + + + International knot + + + + + + + + "m/h" ; "m/hr" + + + Meters per hour + + + + + + + + "m/s" ; "m/sec" + + + Meters per second + + + + + + + + "mph" + + + Miles per hour + + + + + +
+ +

Temperature

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "C" ; "cel" + + + Degree Celsius + + + + + + + + "F" ; "fah" + + + Degree Fahrenheit + + + + + + + + "K" ; "kel" + + + Kelvin + + + + + + + + "Rank" + + + Degree Rankine + + + + + + + + "Reau" + + + Degree Réaumur + + + + + +
+ +

Time

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "day" ; "d" + + + Day + + + + + + + + "hr" + + + Hour + + + + + + + + "mn" ; "min" + + + Minute + + + + + + + + "sec" ; "s" + + + Second + + + + + + + + "yr" + + + Year + + + + + +
+ +

Volume

+ + + + Unit symbol + + + Description + + + Prefix + + + + + "ang3" ; "ang^3" + + + Cubic angstrom + + + + + + + + "barrel" + + + Oil barrel + + + + + + + + "bushel" + + + US bushel + + + + + + + + "cup" + + + US cup + + + + + + + + "ft3" ; "ft^3" + + + Cubic foot + + + + + + + + "gal" + + + US gallon + + + + + + + + "Glass"(2) + + + Australian glass (200 milliliters) + + + + + + + + "GRT" ; "regton" + + + Gross register tonnage + + + + + + + + "Humpen"(2) + + + Humpen (500 milliliters) + + + + + + + + "in3" ; "in^3" + + + Cubic inch + + + + + + + + "l" ; "L" ; "lt" + + + Liter + + + + + + + + "ly3" ; "ly^3" + + + Cubic light-year + + + + + + + + "m3" ; "m^3" + + + Cubic meter + + + + + + + + "mi3" ; "mi^3" + + + Cubic international mile + + + + + + + + "Middy"(2) + + + Australian middy (285 milliliters) + + + + + + + + "MTON" + + + Measurement ton + + + + + + + + "Nmi3" ; "Nmi^3" + + + Cubic nautical mile + + + + + + + + "oz" + + + US fluid ounce + + + + + + + + "Pica3" ; "Pica^3" ; "picapt3" ; "picapt^3" + + + Cubic pica point + + + + + + + + "pica3" ; "pica^3" + + + Cubic pica + + + + + + + + "pt" ; "us_pt" + + + US pint + + + + + + + + "qt" + + + US quart + + + + + + + + "Schooner"(2) + + + Australian schooner (425 milliliters) + + + + + + + + "Sixpack"(2) + + + Six pack (2 liters) + + + + + + + + "tbs" + + + US tablespoon + + + + + + + + "tsp" + + + US teaspoon + + + + + + + + "tspm" + + + Metric teaspoon + + + + + + + + "uk_gal" + + + Imperial gallon + + + + + + + + "uk_pt" + + + Imperial pint + + + + + + + + "uk_qt" + + + Imperial quart + + + + + + + + "yd3" ; "yd^3" + + + Cubic yard + + + + + +
+ 2 - These units are not part of the Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format standard for the CONVERT function. They are preserved for backward compatibility. +
+

Prefixes

+
+

Decimal prefixes

+ + + + Prefix + + + Multiplier + + + + + Y (yotta) + + + 1024 + + + + + Z (zetta) + + + 1021 + + + + + E (exa) + + + 1018 + + + + + P (peta) + + + 1015 + + + + + T (tera) + + + 1012 + + + + + G (giga) + + + 109 + + + + + M (mega) + + + 106 + + + + + k (kilo) + + + 103 + + + + + h (hecto) + + + 102 + + + + + e (deca) + + + 101 + + + + + d (deci) + + + 10-1 + + + + + c (centi) + + + 10-2 + + + + + m (milli) + + + 10-3 + + + + + u (micro) + + + 10-6 + + + + + n (nano) + + + 10-9 + + + + + p (pico) + + + 10-12 + + + + + f (femto) + + + 10-15 + + + + + a (atto) + + + 10-18 + + + + + z (zepto) + + + 10-21 + + + + + y (yocto) + + + 10-24 + + +
+ +

Binary prefixes

+ + + + Prefix + + + Multiplier + + + + + Yi (yobi) + + + 280 + + + + + Zi (zebi) + + + 270 + + + + + Ei (exbi) + + + 260 + + + + + Pi (pebi) + + + 250 + + + + + Ti (tebi) + + + 240 + + + + + Gi (gibi) + + + 230 + + + + + Mi (mebi) + + + 220 + + + + + ki (kibi) + + + 210 + + +
+ + + ORG.OPENOFFICE.CONVERT +
+ CONVERT Wiki page +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_countifs.xhp b/helpcontent2/source/text/scalc/01/func_countifs.xhp new file mode 100644 index 000000000..d2af44ba1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_countifs.xhp @@ -0,0 +1,76 @@ + + + + + + + COUNTIFS function + /text/scalc/01/func_countifs.xhp + + + + +
+ + + COUNTIFS function + counting row;satisfying criteria + counting column;satisfying criteria + +

COUNTIFS

+Returns the count of cells that meet criteria in multiple ranges. +
+ + + +COUNTIFS(Range; Criterion[; Range2; Criterion2][; ... ; [Range127; Criterion127]]) + + +Range, Range2, ... and Criterion, Criterion2, ... must have the same size, otherwise the function returns err:502 - Invalid argument. + + + + +

Simple usage

+=COUNTIFS(B2:B6;">=20") +Counts the amount of rows of the range B2:B6 with values greater than or equal to 20. Returns 3, because the fifth and the sixth rows do not meet the criterion. +=COUNTIFS(B2:B6;">=20";C2:C6;">70") +Counts the amount of rows that contain simultaneously values greater than 70 in the C2:C6 range and values greater than or equal to 20 in the B2:B6 range. Returns 2, because the second, the fifth and the sixth rows do not meet at least one criterion. +

Using regular expressions and nested functions

+For these examples to work as described, make sure that Enable regular expressions in formulas is selected in %PRODUCTNAME - PreferencesTools - Options - $[officename] Calc - Calculate. +=COUNTIFS(B2:B6;"[:alpha:]*") +Counts the amount of rows of the B2:B6 range that contain only alphabet symbols. Returns 1, because only sixth row meets the criterion. +=COUNTIFS(B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6)) +Counts the amount of rows of the B2:B6 range excluding rows with minimum and maximum values of this range. Returns 2, because the third, the fifth and the sixth rows do not meet at least one criterion. +=COUNTIFS(A2:A6;"pen.*";B2:B6;"<"&MAX(B2:B6)) +Counts the amount of rows that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range with exception of its maximum. Returns 1, because only second row meets all criteria. +

Reference to a cell as a criterion

+If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the COUNTIFS function. For example, the above function can be rewritten as follows: +=COUNTIFS(A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6)) +If E2 = pen, the function returns 1, because the link to the cell is substituted with its content and it works as a function above. + +
+ + , + , + , + + + + , + , + , + , + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_date.xhp b/helpcontent2/source/text/scalc/01/func_date.xhp new file mode 100644 index 000000000..bb05e1f80 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_date.xhp @@ -0,0 +1,50 @@ + + + + + +DATE +/text/scalc/01/func_date.xhp + + + +DATE function + +

DATE +

+This function calculates a date specified by year, month, day and displays it in the cell's formatting. The default format of a cell containing the DATE function is the date format, but you can format the cells with any other number format. + + +DATE(Year; Month; Day) + +Year is an integer between 1583 and 9957 or between 0 and 99. +In %PRODUCTNAME - PreferencesTools - Options - $[officename] - General you can set from which year a two-digit number entry is recognized as 20xx. + +Month is an integer indicating the month. + +Day is an integer indicating the day of the month. +If the values for month and day are out of bounds, they are carried over to the next digit. If you enter =DATE(00;12;31) the result will be 2000-12-31. If, on the other hand, you enter =DATE(00;13;31) the result will be 2001-01-31. + + +=DATE(00;1;31) yields 1/31/00 if the cell format setting is MM/DD/YY. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_datedif.xhp b/helpcontent2/source/text/scalc/01/func_datedif.xhp new file mode 100644 index 000000000..c8dae66be --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_datedif.xhp @@ -0,0 +1,113 @@ + + + + + +DATEDIF +/text/scalc/01/func_datedif.xhp + + + +DATEDIF function + + +

DATEDIF

+This function returns the number of whole days, months or years between Start date and End date. + + + + + DATEDIF(Start date; End date; Interval) + + +Start date is the date from when the calculation is carried out. + +End date is the date until the calculation is carried out. End date must be later, than Start date. + +Interval is a string that determines how the difference will be calculated. Possible values are "d", "m", "y", "ym", "md" or "yd" regardless of the current language settings. + + + + + +Value for "Interval"Do not translate the text values in this column below + + +Return value + + + + +"d" + + +Number of whole days between Start date and End date. + + + + + "m" + + +Number of whole months between Start date and End date. + + + + + "y" + + +Number of whole years between Start date and End date. + + + + + "ym" + + +Number of whole months when subtracting years from the difference of Start date and End date. + + + + + "md" + + +Number of whole days when subtracting years and months from the difference of Start date and End date. + + + + + "yd" + + +Number of whole days when subtracting years from the difference of Start date and End date. + + +
+ + + +Birthday calculation. A man was born on 1974-04-17. Today is 2012-06-13. +=DATEDIF("1974-04-17";"2012-06-13";"y") yields 38. +=DATEDIF("1974-04-17";"2012-06-13";"ym") yields 1. +=DATEDIF("1974-04-17";"2012-06-13";"md") yields 27. +So he is 38 years, 1 month and 27 days old. + +=DATEDIF(DATE(1974,4,17);"2012-06-13";"m") yields 457, he has been living for 457 months. + +=DATEDIF("1974-04-17";"2012-06-13";"d") yields 13937, he has been living for 13937 days. + +=DATEDIF("1974-04-17";DATE(2012;06;13);"yd") yields 57, his birthday was 57 days ago. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_datevalue.xhp b/helpcontent2/source/text/scalc/01/func_datevalue.xhp new file mode 100644 index 000000000..963c85926 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_datevalue.xhp @@ -0,0 +1,51 @@ + + + + + + + + + DATEVALUE + /text/scalc/01/func_datevalue.xhp + + + + + DATEVALUE function + + +

DATEVALUE

+ Returns the internal date number for text in quotes. + The internal date number is returned as a number. The number is determined by the date system that is used by $[officename] to calculate dates. + If the text string also includes a time value, DATEVALUE only returns the integer part of the conversion. + + + DATEVALUE("Text") + Text is a valid date expression and must be entered with quotation marks. + + + + + =DATEVALUE("1954-07-20") yields 19925. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_day.xhp b/helpcontent2/source/text/scalc/01/func_day.xhp new file mode 100644 index 000000000..33804020e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_day.xhp @@ -0,0 +1,46 @@ + + + + + +DAY +/text/scalc/01/func_day.xhp + + + +DAY function + +

DAY +

+Returns the day of given date value. The day is returned as an integer between 1 and 31. You can also enter a negative date/time value. + + +DAY(Number) +Number is the internal date number. + + + +=DAY(1) returns 31 (since $[officename] starts counting at zero from December 30, 1899) +=DAY(NOW()) returns the current day. +=DAY(C4) returns 5 if you enter 1901-08-05 in cell C4 (the date value might get formatted differently after you press Enter). +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_days.xhp b/helpcontent2/source/text/scalc/01/func_days.xhp new file mode 100644 index 000000000..fb50701a7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_days.xhp @@ -0,0 +1,46 @@ + + + + + +DAYS +/text/scalc/01/func_days.xhp + + + +DAYS function + +

DAYS +

+Calculates the difference between two date values. The result returns the number of days between the two days. + + +DAYS(Date2; Date1) + +Date1 is the start date, Date2 is the end date. If Date2 is an earlier date than Date1 the result is a negative number. + + + +=DAYS(NOW();"2010-01-01")) returns the number of days from January 1, 2010 until today. +=DAYS("1990-10-10";"1980-10-10") returns 3652 days. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_days360.xhp b/helpcontent2/source/text/scalc/01/func_days360.xhp new file mode 100644 index 000000000..822d7f44f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_days360.xhp @@ -0,0 +1,45 @@ + + + + + +DAYS360 +/text/scalc/01/func_days360.xhp + + + +DAYS360 function + +

DAYS360 +

+Returns the difference between two dates based on the 360 day year used in interest calculations. + + +DAYS360(Date1; Date2[; Type]) +If Date2 is earlier than Date1, the function will return a negative number. +The optional argument Type determines the type of difference calculation. If Type = 0 or if the argument is missing, the US method (NASD, National Association of Securities Dealers) is used. If Type <> 0, the European method is used. + + + +=DAYS360("2000-01-01";NOW()) returns the number of interest days from January 1, 2000 until today. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_eastersunday.xhp b/helpcontent2/source/text/scalc/01/func_eastersunday.xhp new file mode 100644 index 000000000..8227311c4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_eastersunday.xhp @@ -0,0 +1,50 @@ + + + + + +EASTERSUNDAY +/text/scalc/01/func_eastersunday.xhp + + + +EASTERSUNDAY function + +

EASTERSUNDAY +

+Returns the date of Easter Sunday for the entered year. + +EASTERSUNDAY(Year) + +Year is an integer between 1583 and 9956 or 0 and 99. You can also calculate other holidays by simple addition with this date. +Easter Monday = EASTERSUNDAY(Year) + 1 +Good Friday = EASTERSUNDAY(Year) - 2 +Pentecost Sunday = EASTERSUNDAY(Year) + 49 +Pentecost Monday = EASTERSUNDAY(Year) + 50 + +=EASTERSUNDAY(2000) returns 2000-04-23. +=EASTERSUNDAY(2000)+49 returns the internal serial number 36688. The result is 2000-06-11. Format the serial date number as a date, for example in the format YYYY-MM-DD. + + +ORG.OPENOFFICE.EASTERSUNDAY +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_edate.xhp b/helpcontent2/source/text/scalc/01/func_edate.xhp new file mode 100644 index 000000000..14b050236 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_edate.xhp @@ -0,0 +1,49 @@ + + + + + +EDATE +/text/scalc/01/func_edate.xhp + + + +EDATE function + +

EDATE +

+The result is a date which is a number of months away from the start date. Only months are considered; days are not used for calculation. + + +EDATE(StartDate; Months) + +StartDate is a date. + +Months is the number of months before (negative) or after (positive) the start date. + + + +What date is one month prior to 2001-03-31? + +=EDATE("2001-03-31";-1) returns the serial number 36950. Formatted as a date, this is 2001-02-28. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_eomonth.xhp b/helpcontent2/source/text/scalc/01/func_eomonth.xhp new file mode 100644 index 000000000..74d3af592 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_eomonth.xhp @@ -0,0 +1,49 @@ + + + + + +EOMONTH +/text/scalc/01/func_eomonth.xhp + + + +EOMONTH function + +

EOMONTH +

+Returns the date of the last day of a month which falls months away from the start date. + + +EOMONTH(StartDate; Months) + +StartDate is a date (the starting point of the calculation). + +Months is the number of months before (negative) or after (positive) the start date. + +What is the last day of the month that falls 6 months after September 14 2001? + +=EOMONTH(DATE(2001;9;14);6) returns the serial number 37346. Formatted as a date, this is 2002-03-31. +=EOMONTH("2001-09-14";6) works as well. If you specify the date directly, we recommend using the standard ISO 8601 format because this should be independent of your selected locale settings. +
+ EOMONTH wiki page + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_error_type.xhp b/helpcontent2/source/text/scalc/01/func_error_type.xhp new file mode 100644 index 000000000..a1e92361d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_error_type.xhp @@ -0,0 +1,129 @@ + + + + + + + ERROR.TYPE function + /text/scalc/01/func_error_type.xhp + + + + + +
+ + + ERROR.TYPE function + index of the Error type + + +ERROR.TYPE function +Returns a number representing a specific Error type, or the error value #N/A, if there is no error. +
+ + +ERROR.TYPE(Error_value) +Error_value – required argument. The error value or a reference to a cell, whose value needs to be processed. + + + + + Error value + + + Returns + + + + + Err:511 + + + 1 + + + + + #DIV/0! + + + 2 + + + + + #VALUE! + + + 3 + + + + + #REF! + + + 4 + + + + + #NAME? + + + 5 + + + + + #NUM! + + + 6 + + + + + #N/A + + + 7 + + + + + Anything else + + + #N/A + + +
+ + + +Simple usage +=ERROR.TYPE(#N/A) +Returns 7, because 7 is the index number of the error value #N/A. +=ERROR.TYPE(A3) +If A3 contains an expression equivalent to the division by zero, the function returns 2, because 2 is the index number of the error value #DIV/0! +More advanced way +If in division A1 by A2, A2 can turn to zero, you can handle the situation as follows: +=IF(ISERROR(A1/A2);IF(ERROR.TYPE(A1/A2)=2;"the denominator can't be equal to zero");A1/A2) +The ISERROR function returns TRUE or FALSE depending on whether there is an error or not. If the error takes place, the function IF addresses to the second argument, if there is no error, it returns the result of the division. The second argument checks the index number representing the specific Error type, and if it is equal to 2, it returns the specified text "the denominator can't be zero" or 0 otherwise. Thus, clear text would signify the division by zero, the result of the division would appear when the division is successful, or if there is, for example, an error of another type, zero would be returned. +If the ERROR.TYPE function is used as condition of the IF function and the ERROR.TYPE returns #N/A, the IF function returns #N/A as well. Use ISERROR to avoid it as shown in the example above. +
+ISERROR, NA, IF +Error codes +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_findb.xhp b/helpcontent2/source/text/scalc/01/func_findb.xhp new file mode 100644 index 000000000..e28e5e971 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_findb.xhp @@ -0,0 +1,45 @@ + + + + + + + FINDB Function + /text/scalc/01/func_findb.xhp + + + +
+ + + FINDB Function + find text;FINDB Function + +

FINDB

+ Returns the starting position of a given text, using byte positions. FINDB is case sensitive. +
+ + + FINDB(Find Text ; Text [; Position]) + Find Text: The text or text expression to be found. + Text: the text in which the search is to be made. + Position: The position in the text where the search starts. + + =FINDB("ａ"; "LibreOffice Ｃａｌｃ") returns 15. The Find Text argument is a text string that comprises a full-width, double-byte "a" character, while the Text argument comprises 12 single-byte characters followed by four full-width, double-byte characters. +
+ + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_floor.xhp b/helpcontent2/source/text/scalc/01/func_floor.xhp new file mode 100644 index 000000000..044fee3e2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_floor.xhp @@ -0,0 +1,132 @@ + + + + + + FLOOR Functions + /text/scalc/01/func_floor.xhp + + + +

FLOOR Functions

+
+ +FLOOR function +rounding;down to nearest multiple of significance + + mw added one entry + +

FLOOR

+ Rounds a number to the nearest multiple of a significance value. + For a positive number and a positive significance value, the function rounds down (towards zero). For a negative number and a negative significance value, the direction of rounding is determined by the value of a mode parameter. The function returns an error if the number and significance values have opposite signs. +
+ If the spreadsheet is exported to Microsoft Excel, the FLOOR function is exported as the equivalent FLOOR.MATH function that has existed since Excel 2013. If you plan to use the spreadsheet with earlier Excel versions, use either FLOOR.PRECISE that has existed since Excel 2010, or FLOOR.XCL that is exported as the FLOOR function compatible with all Excel versions. +
+ + + FLOOR(Number[; Significance[; Mode]]) +
+ Number is the number that is to be rounded, or a reference to a cell containing the number. +
+ Significance (optional) is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. It defaults to +1 or -1 depending on the sign of Number. + Mode (optional) is a number, or a reference to a cell containing a number. The function only uses Mode if both Number and Significance are negative. Then if Mode is given and not equal to zero, numbers are rounded up (towards zero); if Mode is equal to zero or not given, negative numbers are rounded down (away from zero). + + =FLOOR(3.45) returns 3. + =FLOOR(3.45, 3) returns 3. + =FLOOR(-1.234) returns -2. + =FLOOR(-45.67, -2, 0) returns -46. + =FLOOR(-45.67, -2, 1) returns -44. + see also CEILING, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+ +
+ + +FLOOR.MATH function + +

FLOOR.MATH

+ Rounds a number to the nearest multiple of a significance value. + For a positive number the function rounds down (towards zero). For a negative number, the direction of rounding is determined by the value of a mode parameter. The sign of the significance value is ignored. + This function exists for interoperability with Microsoft Excel 2013 or newer. + + FLOOR.MATH(Number[; Significance[; Mode]]) + + Significance (optional) is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. It defaults to 1. + Mode (optional) is a number, or a reference to a cell containing a number. If Mode is given and not equal to zero, a negative Number is rounded up (towards zero). If Mode is equal to zero or is not given, a negative Number is rounded down (away from zero). + + =FLOOR.MATH(3.45) returns 3. + =FLOOR.MATH(3.45,-3) returns 3. + =FLOOR.MATH(-1.234) returns -2. + =FLOOR.MATH(-45.67,-2, 0) returns -46. + =FLOOR.MATH(-45.67,+2, 1) returns -44. + + + + COM.MICROSOFT.FLOOR.MATH +
+ +
+ +FLOOR.PRECISE function +rounding;down to nearest multiple of significance + + mw added one entry + + + +

FLOOR.PRECISE

+ Rounds a number down to the nearest multiple of a significance value. + For a positive number the function rounds down (towards zero). For a negative number, the function rounds down (away form zero). The sign of the significance value is ignored. + + + FLOOR.PRECISE(Number[; Significance]) + + Significance (optional) is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. It defaults to 1. + + + =FLOOR.PRECISE(3.45) returns 3. + =FLOOR.PRECISE(-45.67,2) returns -46. + + + + COM.MICROSOFT.FLOOR.PRECISE + see also CEILING, EVEN, ODD, MROUND,INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP +
+ +
+ +FLOOR.XCL function + +

FLOOR.XCL

+ Rounds a number to the nearest multiple of a significance value. + For a positive number and a positive significance value, the function rounds down (towards zero). For a negative number and a positive significance value, the function rounds down (away from zero). For a negative number and a negative significance value, the function rounds up (towards zero). The function returns an error if the number is positive and the significance value is negative. + This function exists for interoperability with Microsoft Excel 2007 or older. If a Calc spreadsheet is exported to Microsoft Excel, references to Calc’s FLOOR.XCL function are exported as references to Excel’s FLOOR function, which is compatible with all Excel versions. If a Microsoft Excel spreadsheet is imported into Calc, references to Excel’s FLOOR function are imported as references to Calc’s FLOOR.XCL function. + + FLOOR.XCL(Number; Significance) + + Significance is the value, or a reference to a cell containing the value, to whose multiple Number is to be rounded. + + =FLOOR.XCL(3.45,2) returns 2. + =FLOOR.XCL(-45.67,2) returns -46. + =FLOOR.XCL(-45.67,-2) returns -44. + + + + COM.MICROSOFT.FLOOR +
+
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsadd.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsadd.xhp new file mode 100644 index 000000000..bc981239e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsadd.xhp @@ -0,0 +1,64 @@ + + + + + + + FORECAST.ETS.ADD + /text/scalc/01/func_forecastetsadd.xhp + + + + + +
+ + +FORECAST.ETS.ADD function + + +

FORECAST.ETS.ADD function

+Calculates the additive forecast(s) (future values) based on the historical data using ETS or EDS algorithms. EDS is used when argument period_length is 0, otherwise ETS is used. + +FORECAST.ETS.ADD calculates with the model + + +FORECAST.ETS.ADD(targets, values, timeline, [period_length], [data_completion], [aggregation]) + + + + + + + + + =FORECAST.ETS.ADD(DATE(2014;1;1);Values;Timeline;1;TRUE();1) + Returns 157.166666666667, the additive forecast for January 2014 based on Values and Timeline named ranges above, with one sample per period, no missing data, and AVERAGE as aggregation. + =FORECAST.ETS.ADD(DATE(2014;1;1);Values;Timeline;4;TRUE();7) + Returns 113.251442038722, the additive forecast for January 2014 based on Values and Timeline named ranges above, with period length of 4, no missing data, and SUM as aggregation. + + + +COM.MICROSOFT.FORECAST.ETS +
+
+See also: + FORECAST.ETS.MULT, + FORECAST.ETS.STAT.ADD, + FORECAST.ETS.STAT.MULT, + FORECAST.ETS.PI.ADD, + FORECAST.ETS.PI.MULT, + FORECAST.ETS.SEASONALITY, + FORECAST, + FORECAST.LINEAR + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsmult.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsmult.xhp new file mode 100644 index 000000000..49ea19fd5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsmult.xhp @@ -0,0 +1,65 @@ + + + + + + + FORECAST.ETS.MULT + /text/scalc/01/func_forecastetsmult.xhp + + + + + +
+ + +FORECAST.ETS.MULT function + + +

FORECAST.ETS.MULT Function

+ +Calculates the multiplicative forecast(s) (future values) based on the historical data using ETS or EDS algorithms. EDS is used when argument period_length is 0, otherwise ETS is used. + +FORECAST.ETS.MULT calculates with the model + + +FORECAST.ETS.MULT(targets, values, timeline, [period_length], [data_completion], [aggregation]) + + + + + + + + + =FORECAST.ETS.MULT(DATE(2014;1;1);Values;Timeline;1;TRUE();1) + Returns 131.71437427439, the multiplicative forecast for January 2014 based on Values and Timeline named ranges above, with one sample per period, no missing data, and AVERAGE as aggregation. + =FORECAST.ETS.MULT(DATE(2014;1;1);Values;Timeline;4;TRUE();7) + Returns 120.747806144882, the multiplicative forecast for January 2014 based on Values and Timeline named ranges above, with period length of 4, no missing data, and SUM as aggregation. + + + + ORG.LIBREOFFICE.FORECAST.ETS.MULT +
+
+See also: + FORECAST.ETS.ADD, + FORECAST.ETS.STAT.ADD, + FORECAST.ETS.STAT.MULT, + FORECAST.ETS.PI.ADD, + FORECAST.ETS.PI.MULT, + FORECAST.ETS.SEASONALITY, + FORECAST, + FORECAST.LINEAR + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_forecastetspiadd.xhp b/helpcontent2/source/text/scalc/01/func_forecastetspiadd.xhp new file mode 100644 index 000000000..4c3b6f0ab --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetspiadd.xhp @@ -0,0 +1,69 @@ + + + + + + + FORECAST.ETS.PI.ADD + /text/scalc/01/func_forecastetspiadd.xhp + + + + + +
+ + +FORECAST.ETS.PI.ADD function + +

FORECAST.ETS.PI.ADD function

+ +Calculates the prediction interval(s) for additive forecast based on the historical data using ETS or EDS algorithms. EDS is used when argument period_length is 0, otherwise ETS is used. + +FORECAST.ETS.PI.ADD calculates with the model + + +FORECAST.ETS.PI.ADD(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation]) + + + + + + + +For example, with a 90% Confidence level, a 90% prediction interval will be computed (90% of future points are to fall within this radius from forecast). +Note on prediction intervals: there is no exact mathematical way to calculate this for forecasts, there are various approximations. Prediction intervals tend to be increasingly 'over-optimistic' when increasing distance of the forecast-X from the observation data set. +For ETS, Calc uses an approximation based on 1000 calculations with random variations within the standard deviation of the observation data set (the historical values). + + + =FORECAST.ETS.PI.ADD(DATE(2014;1;1);Values;Timeline;0.9;1;TRUE();1) + Returns 18.8061295551355, the prediction interval for additive forecast for January 2014 based on Values and Timeline named ranges above, 90% (=0.9) confidence level, with one sample per period, no missing data, and AVERAGE as aggregation. + =FORECAST.ETS.PI.ADD(DATE(2014;1;1);Values;Timeline;0.8;4;TRUE();7) + Returns 23.4416821953741, the prediction interval for additive forecast for January 2014 based on Values and Timeline named ranges above, with confidence level of 0.8, period length of 4, no missing data, and SUM as aggregation. + + + + COM.MICROSOFT.FORECAST.ETS.COFINT +
+
+See also: + FORECAST.ETS.ADD, + FORECAST.ETS.MULT, + FORECAST.ETS.STAT.ADD, + FORECAST.ETS.STAT.MULT, + FORECAST.ETS.PI.MULT + FORECAST.ETS.SEASONALITY, + FORECAST, + FORECAST.LINEAR + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_forecastetspimult.xhp b/helpcontent2/source/text/scalc/01/func_forecastetspimult.xhp new file mode 100644 index 000000000..b5d5c1eb9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetspimult.xhp @@ -0,0 +1,69 @@ + + + + + + + FORECAST.ETS.PI.MULT + /text/scalc/01/func_forecastetspimult.xhp + + + + +
+ + +FORECAST.ETS.PI.MULT function + + +

FORECAST.ETS.PI.MULT function

+ +Calculates the prediction interval(s) for multiplicative forecast based on the historical data using ETS or EDS algorithms.. EDS is used when argument period_length is 0, otherwise ETS is used. + +FORECAST.ETS.PI.MULT calculates with the model + + +FORECAST.ETS.PI.MULT(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation]) + + + + + + + +For example, with a 90% Confidence level, a 90% prediction interval will be computed (90% of future points are to fall within this radius from forecast). +Note on prediction intervals: there is no exact mathematical way to calculate this for forecasts, there are various approximations. Prediction intervals tend to be increasingly 'over-optimistic' when increasing distance of the forecast-X from the observation data set. +For ETS, Calc uses an approximation based on 1000 calculations with random variations within the standard deviation of the observation data set (the historical values). + + + =FORECAST.ETS.PI.MULT(DATE(2014;1;1);Values;Timeline;0.9;1;TRUE();1) + Returns 20.1040952101013, the prediction interval for multiplicative forecast for January 2014 based on Values and Timeline named ranges above, confidence level of 90% (=0.9) with one sample per period, no missing data, and AVERAGE as aggregation. + =FORECAST.ETS.PI.MULT(DATE(2014;1;1);Values;Timeline;0.8;4;TRUE();7) + Returns 27.5285874381574, the prediction interval for multiplicative forecast for January 2014 based on Values and Timeline named ranges above, with confidence level of 0.8, period length of 4, no missing data, and SUM as aggregation. + + + + ORG.LIBREOFFICE.FORECAST.ETS.PI.MULT +
+
+See also: + FORECAST.ETS.ADD, + FORECAST.ETS.MULT, + FORECAST.ETS.STAT.ADD, + FORECAST.ETS.STAT.MULT, + FORECAST.ETS.PI.ADD, + FORECAST.ETS.SEASONALITY, + FORECAST, + FORECAST.LINEAR + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsseason.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsseason.xhp new file mode 100644 index 000000000..6fead6db6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsseason.xhp @@ -0,0 +1,61 @@ + + + + + + + FORECAST.ETS.SEASONALITY + /text/scalc/01/func_forecastetsseason.xhp + + + + + +
+ + +FORECAST.ETS.SEASONALITY function + + +

FORECAST.ETS.SEASONALITY Function

+ +Returns the number of samples in period as calculated by Calc in case of FORECAST.ETS functions when argument period_length equals 1. + +The same result is returned with FORECAST.ETS.STAT functions when argument stat_type equals 9 (and period_length equals 1). + +FORECAST.ETS.SEASONALITY (values, timeline, [data_completion], [aggregation]) + + + + + + =FORECAST.ETS.SEASONALITY(Values;Timeline;TRUE();1) + Returns 6, the number of samples in period based on Values and Timeline named ranges above, no missing data, and AVERAGE as aggregation. + + + + COM.MICROSOFT.FORECAST.ETS.SEASONALITY +
+ +
+See also: + FORECAST.ETS.ADD, + FORECAST.ETS.MULT, + FORECAST.ETS.STAT.ADD, + FORECAST.ETS.STAT.MULT, + FORECAST.ETS.PI.ADD, + FORECAST.ETS.PI.MULT, + FORECAST, + FORECAST.LINEAR + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsstatadd.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsstatadd.xhp new file mode 100644 index 000000000..0d7d62bb1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsstatadd.xhp @@ -0,0 +1,67 @@ + + + + + + + FORECAST.ETS.STAT.ADD + /text/scalc/01/func_forecastetsstatadd.xhp + + + + + +
+ + + +FORECAST.ETS.STAT.ADD function + + +

FORECAST.ETS.STAT.ADD Function

+ +Returns statistical value(s) that are results of the ETS/EDS algorithms. + +FORECAST.ETS.STAT.ADD calculates with the model + + +FORECAST.ETS.STAT.ADD (values, timeline, stat_type, [period_length], [data_completion], [aggregation]) + + + + + + + + + =FORECAST.ETS.STAT.ADD(Values;Timeline;3;1;TRUE();1) + Returns 0.9990234375, the additive statistics based on Values and Timeline named ranges above, with beta smoothing, one sample per period, no missing data, and AVERAGE as aggregation. + =FORECAST.ETS.STAT.ADD(Values;Timeline;2;1;TRUE();7) + Returns 0.0615234375, the additive statistics based on Values and Timeline named ranges above, with gamma smoothing, no missing data, and SUM as aggregation. + + + + COM.MICROSOFT.FORECAST.ETS.STAT +
+
+See also: + FORECAST.ETS.ADD , + FORECAST.ETS.MULT , + FORECAST.ETS.STAT.MULT , + FORECAST.ETS.PI.ADD , + FORECAST.ETS.PI.MULT, + FORECAST.ETS.SEASONALITY, + FORECAST, + FORECAST.LINEAR + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsstatmult.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsstatmult.xhp new file mode 100644 index 000000000..4c818cb67 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsstatmult.xhp @@ -0,0 +1,66 @@ + + + + + + + FORECAST.ETS.STAT.MULT + /text/scalc/01/func_forecastetsstatmult.xhp + + + + + +
+ + +FORECAST.ETS.STAT.MULT function + + +

FORECAST.ETS.STAT.MULT Function

+ +Returns statistical value(s) that are results of the ETS/EDS algorithms. + +FORECAST.ETS.STAT.MULT calculates with the model + + +FORECAST.ETS.STAT.MULT (values, timeline, stat_type, [period_length], [data_completion], [aggregation]) + + + + + + + + + =FORECAST.ETS.STAT.MULT(Values;Timeline;5;1;TRUE();1) + Returns 0.084073452803966, the multiplicative statistics based on Values and Timeline named ranges above, with symmetric mean absolute percentage error (SMAPE), one sample per period, no missing data, and AVERAGE as aggregation. + =FORECAST.ETS.STAT.MULT(Values;Timeline;7;1;TRUE();7) + Returns 15.8372533480997, the multiplicative statistics based on Values and Timeline named ranges above, with root mean squared error, no missing data, and SUM as aggregation. + + + + ORG.LIBREOFFICE.FORECAST.ETS.STAT.MULT +
+
+See also: + FORECAST.ETS.ADD, + FORECAST.ETS.MULT, + FORECAST.ETS.STAT.ADD, + FORECAST.ETS.PI.ADD, + FORECAST.ETS.PI.MULT, + FORECAST.ETS.SEASONALITY, + FORECAST, + FORECAST.LINEAR + +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_fourier.xhp b/helpcontent2/source/text/scalc/01/func_fourier.xhp new file mode 100644 index 000000000..d34910924 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_fourier.xhp @@ -0,0 +1,51 @@ + + + + + + + FOURIER function + /text/scalc/01/func_fourier.xhp + + + +
+ + +FOURIER function + +

FOURIER

+ Computes the Discrete Fourier Transform [DFT] of an input array of complex numbers using a couple of Fast Fourier Transform (FFT) algorithms. The function is an array formula. +
+ + + FOURIER(Array; GroupedByColumns [; Inverse [; Polar [; MinimumMagnitude]]]) + Array is a 2 x N or N x 2 range representing an array of complex number to be transformed, where N is the length of the array. The array represents the real and imaginary parts of the data. + + GroupedByColumns is a logical (TRUE or FALSE, 1 or 0) argument. When TRUE the array is grouped by columns where the first column contains the real part of the complex number and the second columns contains the imaginary part of the complex number. When FALSE, the first row contains the real part of the complex number and the second row contains the imaginary part of the complex number. If there is only 1 column (row), the input sequence is treated as purely real. + + Inverse is an optional logical (TRUE or FALSE, 1 or 0) argument. When TRUE, calculates the inverse Discrete Fourier Transform. The default value is FALSE. + + Polar: is an optional logical (TRUE or FALSE, 1 or 0) argument. Indicates whether the final output is in polar coordinates (magnitude, phase). This argument is optional and the default value is FALSE. + + MinimumMagnitude: used only if Polar=TRUE. All frequency components with magnitude less than MinimumMagnitude will be suppressed with a zero magnitude-phase entry. This is very useful when looking at the magnitude-phase spectrum of a signal because there is always some very tiny amount of rounding error when doing FFT algorithms and results in incorrect non-zero phase for non-existent frequencies. By providing a suitable value to this parameter, these non-existent frequency components can be suppressed. By default the value of MinimumMagnitude is 0.0, and no suppression is done by default. + + + + + + + ORG.LIBREOFFICE.FOURIER +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_hour.xhp b/helpcontent2/source/text/scalc/01/func_hour.xhp new file mode 100644 index 000000000..9936d2914 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_hour.xhp @@ -0,0 +1,46 @@ + + + + + +HOUR +/text/scalc/01/func_hour.xhp + + + +HOUR function + +

HOUR +

+Returns the hour for a given time value. The hour is returned as an integer between 0 and 23. + + +HOUR(Number) + +Number, as a time value, is a decimal, for which the hour is to be returned. + + +=HOUR(NOW()) returns the current hour + +=HOUR(C4) returns 17 if the contents of C4 = 17:20:00. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_ifs.xhp b/helpcontent2/source/text/scalc/01/func_ifs.xhp new file mode 100644 index 000000000..26cd70093 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_ifs.xhp @@ -0,0 +1,51 @@ + + + + + + + IFS function + /text/scalc/01/func_ifs.xhp + + + +
+ + + IFS function + +

IFS

+ IFS is a multiple IF-function. +
+ + + IFS(expression1; result1[; expression2; result2][; ... ; [expression127; result127]]) + expression1, expression2, ... are any boolean values or expressions that can be TRUE or FALSE + result1, result2, ... are the values that are returned if the logical test is TRUE + IFS( expression1, result1, expression2, result2, expression3, result3 ) is executed as + IF expression1 is TRUE + THEN result1 + ELSE IF expression2 is TRUE + THEN result2 + ELSE IF expression3 is TRUE + THEN result3 + To get a default result should no expression be TRUE, add a last expression that is always TRUE, like TRUE or 1=1 followed by the default result. + If there is a result missing for an expression or is no expression is TRUE, a #N/A error is returned. + If expression is neither TRUE or FALSE, a #VALUE error is returned. + + + + COM.MICROSOFT.IFS +
+ + IF +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imcos.xhp b/helpcontent2/source/text/scalc/01/func_imcos.xhp new file mode 100644 index 000000000..c2a4e7fdb --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcos.xhp @@ -0,0 +1,72 @@ + + + + + + IMCOS function + /text/scalc/01/func_imcos.xhp + + + +
+ + + IMCOS function + cosine;complex number + +

+ + IMCOS + function +

+ + + Returns the cosine of a complex number. The cosine of a complex number can be expressed by: + + +
+ + IMCOS equation + + + + + + IMCOS(Complex_number) + + + Complex_number is a complex number whose cosine is to be calculated. + + +
+ + + +
+ + + + + =IMCOS("4-3i")
+ returns -6.58066304055116-7.58155274274654i. + + + =IMCOS(2)
+ returns -0.416146836547142 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imcosh.xhp b/helpcontent2/source/text/scalc/01/func_imcosh.xhp new file mode 100644 index 000000000..718b490db --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcosh.xhp @@ -0,0 +1,73 @@ + + + + + + IMCOSH function + /text/scalc/01/func_imcosh.xhp + + + +
+ + + IMCOSH function + hyperbolic cosine;complex number + +

+ + IMCOSH + function +

+ + + Returns the hyperbolic cosine of a complex number. The hyperbolic cosine of a complex number can be expressed by: + + +
+ + IMCOSH equation + + + + + + + IMCOSH(Complex_number) + + + Complex_number is a complex number whose hyperbolic cosine is to be calculated. + + +
+ + + +
+ + + + + =IMCOSH("4-3i")
+ returns -27.0349456030742-3.85115333481178i. + + + =IMCOSH(2)
+ returns 3.76219569108363 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imcot.xhp b/helpcontent2/source/text/scalc/01/func_imcot.xhp new file mode 100644 index 000000000..715540017 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcot.xhp @@ -0,0 +1,71 @@ + + + + + + IMCOT function + /text/scalc/01/func_imcot.xhp + + + +
+ + + IMCOT function + cotangent;complex number + +

+ + IMCOT + function +

+ + + Returns the cotangent of a complex number. The cotangent of a complex number can be expressed by: + + +
+ + IMCOT equation + + + + + + + IMCOT(Complex_number) + + + Complex_number is a complex number whose cotangent is to be calculated. + + +
+ + + +
+ + + + + =IMCOT("4-3i")
+ returns 0.00490118239430447+0.999266927805902i. + + + =IMCOT(2)
+ returns -0.457657554360286 as a string. + + +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imcsc.xhp b/helpcontent2/source/text/scalc/01/func_imcsc.xhp new file mode 100644 index 000000000..ac1504080 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcsc.xhp @@ -0,0 +1,73 @@ + + + + + + IMCSC function + /text/scalc/01/func_imcsc.xhp + + + +
+ + + IMCSC function + cosecant;complex number + +

+ + IMCSC + function +

+ + + Returns the cosecant of a complex number. The cosecant of a complex number can be expressed by: + + +
+ + IMCSC equation + + + + + + + IMCSC(Complex_number) + + + Complex_number is a complex number whose cosecant needs to be calculated. + + +
+ + + +
+ + + + + =IMCSC("4-3i")
+ returns -0.0754898329158637-0.0648774713706355i. + + + =IMCSC(2)
+ returns 1.09975017029462 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imcsch.xhp b/helpcontent2/source/text/scalc/01/func_imcsch.xhp new file mode 100644 index 000000000..cd854aae4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcsch.xhp @@ -0,0 +1,73 @@ + + + + + + IMCSCH function + /text/scalc/01/func_imcsch.xhp + + + +
+ + + IMCSCH function + hyperbolic cosecant;complex number + +

+ + IMCSCH + function +

+ + + Returns the hyperbolic cosecant of a complex number. The hyperbolic cosecant of a complex number can be expressed by: + + +
+ + IMCSCH equation + + + + + + + IMCSCH(Complex_number) + + + Complex_number is a complex number whose hyperbolic cosecant needs to be calculated. + + +
+ + + +
+ + + + + =IMCSCH("4-3i")
+ returns -0.036275889628626+0.0051744731840194i. + + + =IMCSCH(2)
+ returns 0.275720564771783 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imsec.xhp b/helpcontent2/source/text/scalc/01/func_imsec.xhp new file mode 100644 index 000000000..ccf6b8f2b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsec.xhp @@ -0,0 +1,73 @@ + + + + + + IMSEC function + /text/scalc/01/func_imsec.xhp + + + +
+ + + IMSEC function + secant;complex number + +

+ + IMSEC + function +

+ + + Returns the secant of a complex number. The secant of a complex number can be expressed by: + + +
+ + IMSEC equation + + + + + + + IMSEC(Complex_number) + + + Complex_number is a complex number whose secant needs to be calculated. + + +
+ + + +
+ + + + + =IMSEC("4-3i")
+ returns -0.0652940278579471+0.0752249603027732i. + + + =IMSEC(2)
+ returns -2.40299796172238 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imsech.xhp b/helpcontent2/source/text/scalc/01/func_imsech.xhp new file mode 100644 index 000000000..fc5155fd2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsech.xhp @@ -0,0 +1,73 @@ + + + + + + IMSECH function + /text/scalc/01/func_imsech.xhp + + + +
+ + + IMSECH function + hyperbolic secant;complex number + +

+ + IMSECH + function +

+ + + Returns the hyperbolic secant of a complex number. The hyperbolic secant of a complex number can be expressed by: + + +
+ + IMSECH equation + + + + + + + IMSECH(Complex_number) + + + Complex_number is a complex number whose hyperbolic secant needs to be calculated. + + +
+ + + +
+ + + + + =IMSECH("4-3i")
+ returns -0.0362534969158689+0.00516434460775318i. + + + =IMSECH(2)
+ returns 0.26580222883408 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imsin.xhp b/helpcontent2/source/text/scalc/01/func_imsin.xhp new file mode 100644 index 000000000..3fb20db2f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsin.xhp @@ -0,0 +1,72 @@ + + + + + + IMSIN function + /text/scalc/01/func_imsin.xhp + + + +
+ + + IMSIN function + sine;complex number + +

+ + IMSIN + function +

+ + + Returns the sine of a complex number. The sine of a complex number can be expressed by: + + +
+ + IMSIN equation + + + + + + IMSIN(Complex_number) + + + Complex_number is a complex number whose sine needs to be calculated. + + +
+ + + +
+ + + + + =IMSIN("4-3i")
+ returns -7.61923172032141+6.548120040911i. + + + =IMSIN(2)
+ returns 0.909297426825682 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imsinh.xhp b/helpcontent2/source/text/scalc/01/func_imsinh.xhp new file mode 100644 index 000000000..058c31927 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsinh.xhp @@ -0,0 +1,73 @@ + + + + + + IMSINH function + /text/scalc/01/func_imsinh.xhp + + + +
+ + + IMSINH function + hyperbolic sine;complex number + +

+ + IMSINH + function +

+ + + Returns the hyperbolic sine of a complex number. The hyperbolic sine of a complex number can be expressed by: + + +
+ + IMSINH equation + + + + + + + IMSINH(Complex_number) + + + Complex_number is a complex number whose hyperbolic sine needs to be calculated. + + +
+ + + +
+ + + + + =IMSINH("4-3i")
+ returns -27.0168132580039-3.85373803791938i. + + + =IMSINH(2)
+ returns 3.62686040784702 as a string. + + +
+ + , + , + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_imtan.xhp b/helpcontent2/source/text/scalc/01/func_imtan.xhp new file mode 100644 index 000000000..edabfe86c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imtan.xhp @@ -0,0 +1,71 @@ + + + + + + IMTAN function + /text/scalc/01/func_imtan.xhp + + + +
+ + + IMTAN function + tangent;complex number + +

+ + IMTAN + function +

+ + + Returns the tangent of a complex number. The tangent of a complex number can be expressed by: + + +
+ + IMTAN equation + + + + + + + IMTAN(Complex_number) + + + Complex_number is a complex number whose tangent is to be calculated. + + +
+ + + +
+ + + + + =IMTAN("4-3i")
+ returns 0.00490825806749606-1.00070953606723i. + + + =IMTAN(2)
+ returns -2.18503986326152 as a string. + + +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_isoweeknum.xhp b/helpcontent2/source/text/scalc/01/func_isoweeknum.xhp new file mode 100644 index 000000000..96f58c866 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_isoweeknum.xhp @@ -0,0 +1,48 @@ + + + + + +ISOWEEKNUM +/text/scalc/01/func_isoweeknum.xhp + + + +ISOWEEKNUM function + +

ISOWEEKNUM +

+ISOWEEKNUM calculates the week number of the year for the internal date value. +The International Standard ISO 8601 has decreed that Monday shall be the first day of the week. A week that lies partly in one year and partly in another is assigned a number in the year in which most of its days lie. That means that week number 1 of any year is the week that contains the January 4th. + + + +ISOWEEKNUM(Number) + +Number is the internal date number. + + + +=ISOWEEKNUM(DATE(1995;1;1)) returns 52. Week 1 starts on Monday, 1995-01-02. +=ISOWEEKNUM(DATE(1999;1;1)) returns 53. Week 1 starts on Monday, 1999-01-04. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_jis.xhp b/helpcontent2/source/text/scalc/01/func_jis.xhp new file mode 100644 index 000000000..ef94de403 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_jis.xhp @@ -0,0 +1,41 @@ + + + + + + + JIS Function + /text/scalc/01/func_jis.xhp + + + +
+ + + JIS function + +

JIS

+ Converts single-byte (half-width) ASCII or katakana characters to double-byte (full-width) characters. +
+ See https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions for a conversion table. + + JIS(Text) + Text: the text string that contains characters to be converted. + Applying the JIS function to a string composed of double-byte characters will return the input string without any modifications. + + =JIS("LibreOffice") returns the string "ＬｉｂｒｅＯｆｆｉｃｅ". Note that the returned string uses double-byte characters. + =JIS("ﾗｲﾄ") returns the string "ライト", which is composed of double-byte characters. + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_maxifs.xhp b/helpcontent2/source/text/scalc/01/func_maxifs.xhp new file mode 100644 index 000000000..ec778f57d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_maxifs.xhp @@ -0,0 +1,78 @@ + + + + + + + MAXIFS function + /text/scalc/01/func_maxifs.xhp + + + + +
+ + + MAXIFS function + maximum;satisfying conditions + +

MAXIFS function

+Returns the maximum of the values of cells in a range that meets multiple criteria in multiple ranges. +
+ +MAXIFS() + +Func_Range – required argument. A range of cells, a name of a named range or a label of a column or a row containing values for calculating the maximum. + + + + + + + + + +

Simple usage

+=MAXIFS(B2:B6;B2:B6;"<35") +Calculates the maximum of values of the range B2:B6 that are greater than or equal to 20. Returns 35. The fifth row does not meet the criterion. +=MAXIFS(C2:C6;B2:B6;">=20";C2:C6;"<90") +Calculates the maximum of values of the range C2:C6 that are lower than 90 and correspond to cells of the B2:B6 range with values greater than or equal to 20. Returns 85, because the fourth and fifth rows do not meet at least one criterion. +

Using regular expressions and nested functions

+=MAXIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6)) +Calculates the maximum of values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 190, because only the fourth row meet the criteria. +=MAXIFS(C2:C6;A2:A6;"pen.*";B2:B6;"<="&MAX(B2:B6)) +Calculates the maximum of values of the range C2:C6 that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range except its maximum. Returns 85, because only the third row meets all criteria. +

Reference to a cell as a criterion

+If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the MAXIFS function. For example, the above function can be rewritten as follows: +=MAXIFS(C2:C6;A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6)) +If E2 = "pen", the function returns 65, because the reference to the cell is substituted with its content. + + + + +COM.MICROSOFT.MAXIFS +
+ +, +, +, +, + + +, +, +, +, + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_minifs.xhp b/helpcontent2/source/text/scalc/01/func_minifs.xhp new file mode 100644 index 000000000..c5ddde101 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_minifs.xhp @@ -0,0 +1,79 @@ + + + + + + + MINIFS function + /text/scalc/01/func_minifs.xhp + + + + +
+ + + MINIFS function + minimum;satisfying conditions + +

MINIFS function

+Returns the minimum of the values of cells in a range that meets multiple criteria in multiple ranges. +
+ +MINIFS() + +Func_Range – required argument. A range of cells, a name of a named range or a label of a column or a row containing values for calculating the minimum. + + + + + + + + + +

Simple usage

+=MINIFS(B2:B6;B2:B6;"<35") +Calculates the minimum of values of the range B2:B6 that are lower than or equal to 20. Returns 17. +=MINIFS(C2:C6;B2:B6;">=20";C2:C6;">90") +Calculates the minimum of values of the range C2:C6 that are lower than 90 and correspond to cells of the B2:B6 range with values greater than or equal to 20. Returns 190. +

Using regular expressions and nested functions

+=MINIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6)) +Calculates the minimum of values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 65. +=MINIFS(C2:C6;A2:A6;".*book";B2:B6;">"&MIN(B2:B6)) +Calculates the minimum of values of the range C2:C6 that correspond to all cells of the A2:A6 range ending with "book" and to all cells of the B2:B6 range except its minimum. Returns 190. +

Reference to a cell as a criterion

+If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the MINIFS function. For example, the above function can be rewritten as follows: +=MINIFS(C2:C6;A2:A6;".*"&E2;B2:B6;"<"&MAX(B2:B6)) +If E2 = "book", the function returns 180, because the reference to the cell is substituted with its content. + + + + +COM.MICROSOFT.MINIFS +
+ +, +, +, +, + + +, +, +, +, + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_minute.xhp b/helpcontent2/source/text/scalc/01/func_minute.xhp new file mode 100644 index 000000000..1bea6607f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_minute.xhp @@ -0,0 +1,48 @@ + + + + + +MINUTE +/text/scalc/01/func_minute.xhp + + + +MINUTE function + +

MINUTE +

+Calculates the minute for an internal time value. The minute is returned as a number between 0 and 59. + + +MINUTE(Number) + +Number, as a time value, is a decimal number where the number of the minute is to be returned. + + +=MINUTE(8.999) returns 58 + +=MINUTE(8.9999) returns 59 + +=MINUTE(NOW()) returns the current minute value. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_month.xhp b/helpcontent2/source/text/scalc/01/func_month.xhp new file mode 100644 index 000000000..9ae8ce5f5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_month.xhp @@ -0,0 +1,46 @@ + + + + + +MONTH +/text/scalc/01/func_month.xhp + + + +MONTH function + +

MONTH +

+Returns the month for the given date value. The month is returned as an integer between 1 and 12. + + +MONTH(Number) + + Number is the internal date number. + + + +=MONTH(NOW()) returns the current month. +=MONTH(C4) returns 7 if you enter 2000-07-07 to cell C4 (that date value might get formatted differently after you press Enter). +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_networkdays.intl.xhp b/helpcontent2/source/text/scalc/01/func_networkdays.intl.xhp new file mode 100644 index 000000000..4a5e6d7b6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_networkdays.intl.xhp @@ -0,0 +1,61 @@ + + + + + + + NETWORKDAYS.INTL + /text/scalc/01/func_networkdays.intl.xhp + + + + +
+ + NETWORKDAYS.INTL function + + +

NETWORKDAYS.INTL

+Returns the number of workdays between a start date and an end date. There are options to define weekend days and holidays. The optional weekend parameter (or a string) can be used to define the weekend days (or the non-working days in each week). Also, optionally, the user can define a holiday list. The weekend days and user-defined holidays are not counted as working days. +
+ +NETWORKDAYS.INTL(StartDate; EndDate [; [ Weekend ] [; Holidays ] ]) +StartDate is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation. +EndDate is the date up until when the calculation is carried out. If the end date is a workday, the day is included in the calculation. + + + + + +How many workdays fall between December 15, 2016 and January 14, 2017? Let the start date be located in C3 and the end date in D3. Cells F3 to J3 contain five (5) holidays for Christmas and New Year in date format: December 24, 2016; December 25, 2016; December 26, 2016; December 31, 2016; and January 1, 2017. +=NETWORKDAYS.INTL(C3;D3;;F3:J3) returns 21 workdays with default for weekend days. +=NETWORKDAYS.INTL(C3;D3;11;F3:J3) returns 24 workdays with Sunday only weekends. +Alternatively, use the weekend string “0000001” to define Sunday as the non-working day of every week. +=NETWORKDAYS.INTL(C3;D3;“0000001”;F3:J3) returns 24 workdays with Sunday only weekend. +The function can be used without the two optional parameters – weekday and holidays – by leaving them out: +=NETWORKDAYS.INTL(C3;D3) gives 22 working days. + + + +COM.MICROSOFT.NETWORKDAYS.INTL +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_networkdays.xhp b/helpcontent2/source/text/scalc/01/func_networkdays.xhp new file mode 100644 index 000000000..dc5681d14 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_networkdays.xhp @@ -0,0 +1,59 @@ + + + + + + + NETWORKDAYS + /text/scalc/01/func_networkdays.xhp + + + + + + + NETWORKDAYS function + NETWORKDAYS_EXCEL2003 function + + + + +

NETWORKDAYS

+Returns the number of workdays between a start date and an end date. Holidays can be deducted. + + + +NETWORKDAYS(StartDate; EndDate [; [ Holidays ] [; Workdays ] ]) +StartDate is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation. +EndDate is the date up until when the calculation is carried out. If the end date is a workday, the day is included in the calculation. +Holidays is an optional list of holidays. These are non-working days. Enter a cell range in which the holidays are listed individually. +Workdays is an optional list of number values defining standard work week. This list starts by Sunday, workdays are indicated by zero and non-working days by non-zero value. + + + + +How many workdays fall between 2001-12-15 and 2002-01-15? The start date is located in C3 and the end date in D3. Cells F3 to J3 contain the following Christmas and New Year holidays: "2001-12-24", "2001-12-25", "2001-12-26", "2001-12-31", "2002-01-01". +=NETWORKDAYS(C3;D3;F3:J3) returns 17 workdays. +How many workdays fall between September 12nd and 25th in 2016 if only Mondays, Tuesdays and Wednesdays are considered as workdays? +=NETWORKDAYS(DATE(2016;9;12); DATE(2016;9;25); ; {1;0;0;0;1;1;1}) returns 6 workdays. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_now.xhp b/helpcontent2/source/text/scalc/01/func_now.xhp new file mode 100644 index 000000000..45227d288 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_now.xhp @@ -0,0 +1,44 @@ + + + + + +NOW +/text/scalc/01/func_now.xhp + + + +NOW function + +

NOW +

+Returns the computer system date and time. The value is updated when you recalculate the document or each time a cell value is modified. + + + +NOW() +NOW is a function without arguments. + + +=NOW()-A1 returns the difference between the date in A1 and now. Format the result as a number. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_numbervalue.xhp b/helpcontent2/source/text/scalc/01/func_numbervalue.xhp new file mode 100644 index 000000000..b0c8f385e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_numbervalue.xhp @@ -0,0 +1,60 @@ + + + + + + + NUMBERVALUE + /text/scalc/01/func_numbervalue.xhp + + + + + NUMBERVALUE function + + +

NUMBERVALUE

+ + Converts the string representation of a number into a locale-independent numeric value. + + + The input text may be in a locale-dependent or other bespoke format. + The output number is formatted as a valid floating point value and shown using the current cell's number format. + Refer to the Numbers / Format help page to learn how to change the format of numbers in a cell. + + NUMBERVALUE(Text[; Decimal Separator[; Group Separator]]) + Text is a string that contains the number to be converted. + Decimal Separator is a single character that specifies the decimal separator in Text. It can be omitted if Text does not include any decimal or group separators. + Group Separator is a string that specifies the character(s) used as the group separator in Text. It can be omitted if Text does not include any group separators. The Decimal Separator character should not be used in Group Separator. + + + =NUMBERVALUE("1.234.567,89"; ","; ".") returns 1234567.89 (considering en-US locale). The function removes the two group separators and changes the decimal separator from a comma to a full stop. + + =NUMBERVALUE("123·4"; "·") returns 123.4 (considering en-US locale). The function changes the decimal separator from a "·" to a full stop. No group separator is used in the supplied number and so the Group Separator argument is omitted. + + =NUMBERVALUE("123e12") returns 1.23E+14 (considering en-US locale). No decimal or group separators are used in the supplied number and so the Decimal Separator and Group Separator arguments are omitted. + + =NUMBERVALUE("1#!234#!567"; "."; "#!") returns 1234567 (considering en-US locale). Note that in this case the group separator is specified as a two-character string. + Refer to the NUMBERVALUE wiki page for more details about this function. + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_opt_barrier.xhp b/helpcontent2/source/text/scalc/01/func_opt_barrier.xhp new file mode 100644 index 000000000..3c9b23401 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_barrier.xhp @@ -0,0 +1,58 @@ + + + + + + + Function OPT_BARRIER + /text/scalc/01/func_opt_barrier.xhp + + + +
+ + OPT_BARRIER function + + +

OPT_BARRIER

+ Returns the pricing for a barrier option, calculated using the Black-Scholes option pricing model. +
+ + + OPT_BARRIER(Spot; Volatility; Rate; Foreign Rate; Maturity; Strike; LowerBarrier; UpperBarrier; Rebate; PutCall; InOut; BarrierMonitoring [; Greek]) + + + + + + Strike is the strike price of the option and should be non-negative. + + + Rebate is the amount of money to be paid at maturity if the barrier is hit. + Put or Call is a string that defines whether the option is a put (“p”) or a call (“c”). + + + + + =OPT_BARRIER(30;0.2;0.06;0;1;40;25;0;0;"c";"o";"c") returns the value 0.4243. + =OPT_BARRIER(50;0.4;0.05;0;0.5;65;0;80;0;"p";"o";"c";"e") returns the value 10.1585. + + + + COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTBARRIER +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_opt_prob_hit.xhp b/helpcontent2/source/text/scalc/01/func_opt_prob_hit.xhp new file mode 100644 index 000000000..3737e6c7c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_prob_hit.xhp @@ -0,0 +1,56 @@ + + + + + + + Function OPT_PROB_HIT + /text/scalc/01/func_opt_prob_hit.xhp + + + +
+ + OPT_PROB_HIT function + + +

OPT_PROB_HIT

+ Returns the probability that an asset hits a predetermined barrier price, assuming that the stock price can be modeled as a process S that follows the stochastic differential equation, as follows. + + OPT_PROB_HIT equation + + µ is the asset’s percentage drift, vol is the percentage volatility of the stock, and dW is a random sample drawn from a normal distribution with a zero mean. W is a Wiener process or Brownian motion. +
+ + + OPT_PROB_HIT(Spot; Volatility; Drift; Maturity; LowerBarrier; UpperBarrier) + + + Drift is the annual stock price percentage drift rate (µ in the above formula). The value is expressed as a decimal (for example, enter 15% as 0.15). + + Strike is the strike price of the option and should be non-negative. + + + + =OPT_PROB_HIT(30;0.2;0.3;1;0;40) returns the value 0.6119. + =OPT_PROB_HIT(70;0.3;0.1;0.5;60;0) returns the value 0.4239. + + + + COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTPROBHIT +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_opt_prob_inmoney.xhp b/helpcontent2/source/text/scalc/01/func_opt_prob_inmoney.xhp new file mode 100644 index 000000000..c5a6cab98 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_prob_inmoney.xhp @@ -0,0 +1,65 @@ + + + + + + + Function OPT_PROB_INMONEY + /text/scalc/01/func_opt_prob_inmoney.xhp + + + +
+ + OPT_PROB_INMONEY function + + +

OPT_PROB_INMONEY

+ Returns the probability that an asset will end up between two barrier levels at maturity, assuming that the stock price can be modeled as a process S that follows the stochastic differential equation, as follows. + + OPT_PROB_INMONEY equation + + µ is the asset’s percentage drift, vol is the percentage volatility of the stock, and dW is a random sample drawn from a normal distribution with a zero mean. W is a Wiener process or Brownian motion. + If the optional Strike and PutCall arguments are included, then + + + For a call option, the function returns the probability that the asset will end up between Strike and UpperBarrier. + + + For a put option, the function returns the probability that the asset will end up between LowerBarrier and Strike. + + + The function ignores the possibility of knock-out before maturity. +
+ + + OPT_PROB_INMONEY(Spot; Volatility; Drift; Maturity; LowerBarrier; UpperBarrier [; Strike [; PutCall]]) + + + + + + + + =OPT_PROB_INMONEY(30;0.2;0.1;1;0;50) returns the value 0.9844. + =OPT_PROB_INMONEY(70;0.3;0.15;1;60;0;80;"p") returns the value 0.3440. + + + + COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTPROBINMONEY +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_opt_touch.xhp b/helpcontent2/source/text/scalc/01/func_opt_touch.xhp new file mode 100644 index 000000000..9abb0c37b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_touch.xhp @@ -0,0 +1,92 @@ + + + + + + + OPT_TOUCH + /text/scalc/01/func_opt_touch.xhp + + + +
+ + OPT_TOUCH function + + +

OPT_TOUCH

+ Returns the pricing of a touch / no-touch option, calculated using the Black-Scholes option pricing model. +
+
+ For relevant background information, visit the Options (finance) and Black-Scholes model Wikipedia pages. +
+ Further information about touch / no-touch options may be found on many financial websites. + + OPT_TOUCH(Spot; Volatility; Rate; ForeignRate; Maturity; LowerBarrier; UpperBarrier; ForeignDomestic; InOut; BarrierMonitoring [; Greek]) + + Spot is the price / value of the underlying asset and should be greater than 0.0. + Volatility is the annual percentage volatility of the underlying asset expressed as a decimal (for example, enter 30% as 0.3). The value should be greater than 0.0. + Rate is the continuously compounded interest rate. This is a percentage expressed as a decimal (for example, enter 40% as 0.4). + ForeignRate is the continuously compounded foreign interest rate. This is a percentage expressed as a decimal (for example, enter 50% as 0.5). + Maturity is the time to maturity of the option, in years, and should be non-negative. + LowerBarrier is the predetermined lower barrier price; set to zero for no lower barrier. + UpperBarrier is the predetermined upper barrier price; set to zero for no upper barrier. + ForeignDomestic is a string that defines whether the option pays domestic (“d”) or foreign (“f”) currency. + InOut is a string that defines whether the option is knock-in (“i”) or knock-out (“o”). + BarrierMonitoring is a string that defines whether the barrier is monitored continuously (“c”) or only at the end / maturity (“e”). +
+ Greek (optional) is a string argument. If omitted or set to “value”, “v”, “price”, or “p”, then the function simply returns the option price. If another valid string is entered, the function returns price sensitivities (Greeks) to one of the input parameters. The valid options in this case are as follows. + + + “delta” or “d”. + + + “gamma” or “g”. + + + “theta” or “t”. + + + “vega” or “e”. + + + “volga” or “o”. + + + “vanna” or “a”. + + + “rho” or “r”. + + + “rhof” or “f”. + + +
+ + =OPT_TOUCH(50;0.25;0.05;0;1;0;55;"d";"i";"c") returns the value 0.6876. + =OPT_TOUCH(80;0.2;0.05;0;0.5;60;0;"f";"o";"c";"r") returns the value 15.5516. + + + + COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTTOUCH +
+ + + + +
+ Financial Functions Part One + Financial Functions Part Two + Financial Functions Part Three +
+
+ + diff --git a/helpcontent2/source/text/scalc/01/func_rawsubtract.xhp b/helpcontent2/source/text/scalc/01/func_rawsubtract.xhp new file mode 100644 index 000000000..6d59f956f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_rawsubtract.xhp @@ -0,0 +1,43 @@ + + + + + + RAWSUBTRACT function + /text/scalc/01/func_rawsubtract.xhp + + + +
+ + + rawsubtract;subtraction + RAWSUBTRACT function + +
+

RAWSUBTRACT

+ Subtracts a set of numbers and gives the result without eliminating small roundoff errors. +
+ + RAWSUBTRACT(Minuend; Subtrahend 1[; Subtrahend 2][; … ;[ Subtrahend 254]]) + Minuend is a number or a reference to a cell containing a number. + Subtrahend 1[; Subtrahend 2][; ... ;[ Subtrahend 254]] are numbers or references to cells containing numbers. + The function should be called with at least two parameters. + RAWSUBTRACT() processes arguments from left to right. For example, RAWSUBTRACT(1;2;3;4) calculates 1-2-3-4 or ((1-2)-3)-4 in "natural" order. + + =RAWSUBTRACT(0.987654321098765, 0.9876543210987) returns 6.53921361504217E-14 + =RAWSUBTRACT(0.987654321098765) returns Err:511 (Missing variable) because RAWSUBTRACT requires a minimum of two numbers. + + + + ORG.LIBREOFFICE.RAWSUBTRACT +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_regex.xhp b/helpcontent2/source/text/scalc/01/func_regex.xhp new file mode 100644 index 000000000..82119a3df --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_regex.xhp @@ -0,0 +1,51 @@ + + + + + + + REGEX Function + /text/scalc/01/func_regex.xhp + + + +
+ + + REGEX function + regular expressions;extracting in spreadsheets + regular expressions;REGEX function + +

REGEX

+ Matches and extracts or optionally replaces text using regular expressions. +
+ + REGEX( Text ; Expression [ ; [ Replacement ] [ ; Flags|Occurrence ] ] ) + Text: A text or reference to a cell where the regular expression is to be applied. + Expression: A text representing the regular expression, using ICU regular expressions. If there is no match and Replacement is not given, #N/A is returned. + Replacement: Optional. The replacement text and references to capture groups. If there is no match, Text is returned unmodified. + Flags: Optional. "g" replaces all matches of Expression in Text, not extracted. If there is no match, Text is returned unmodified. + Occurrence: Optional. Number to indicate which match of Expression in Text is to be extracted or replaced. If there is no match and Replacement is not given, #N/A is returned. If there is no match and Replacement is given, Text is returned unmodified. If Occurrence is 0, Text is returned unmodified. + + =REGEX("123456ABCDEF";"[:digit:]";"Z") returns "Z23456ABCDEF", where the first match of a digit is replaced by "Z". + =REGEX("123456ABCDEF";"[:digit:]";"Z";"g") returns "ZZZZZZABCDEF", where all digits were replaced by "Z". + =REGEX("123456ABCDEF";"[126]";"";"g") returns "345ABCDEF", where any occurrence of "1", "2" or "6" is replaced by the empty string, thus deleted. + =REGEX("axbxcxd";".x";;2) returns "bx", the second match of ".x". + =REGEX("axbxcxd";"(.)x";"$1y";2) returns "axbycxd", the second match of "(.)x" (i.e. "bx") replaced with the captured group of one character (i.e. "b") followed by "y". + + + + ORG.LIBREOFFICE.REGEX +
+ List of regular expressions + ICU regular expressions +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_replaceb.xhp b/helpcontent2/source/text/scalc/01/func_replaceb.xhp new file mode 100644 index 000000000..a2e85b72c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_replaceb.xhp @@ -0,0 +1,50 @@ + + + + + + + REPLACEB Function + /text/scalc/01/func_replaceb.xhp + + + +
+ + + REPLACEB Function + replace text;REPLACEB Function + +

REPLACEB

+ Returns text where an old text is replaced with a new text, using byte positions. +
+ + + REPLACEB( Text ; Position ; Length ; NewText ) + Text: A text expression or reference to a cell containing a text expression in which the bytes are to be replaced. + Position: the byte position from which text is to be replaced. + Length: the number of bytes to be replaced. + NewText: the text to be inserted. + + + =REPLACEB("ᄩᄔᄕᄜᄝᄞᄠᄢᄣᄫᄬᄭᄮᄯᄲᄶ";4;1;"ab") returns "ᄩ abᄕᄜᄝᄞᄠᄢᄣᄫᄬᄭᄮᄯᄲᄶ" . + + Refer to the REPLACEB wiki page for more details about this function. + +
+ + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_roman.xhp b/helpcontent2/source/text/scalc/01/func_roman.xhp new file mode 100644 index 000000000..4600ab3fc --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_roman.xhp @@ -0,0 +1,46 @@ + + + + + + + ROMAN Function + /text/scalc/01/func_roman.xhp + + + +
+ + + ROMAN function + text functions;convert to roman numbers + +

ROMAN

+ Converts a number into a Roman numeral. The value range must be between 0 and 3999. A simplification mode can be specified in the range from 0 to 4. +
+ + ROMAN(Number [; Mode]) + Number: the number that is to be converted into a Roman numeral. + Mode: optional value ranging between 0 to 4 that indicates the degree of simplification to be used in the conversion. The higher the value, the greater is the simplification of the Roman number. + + =ROMAN(999) returns "CMXCIX" (uses simplification mode equal to zero, which is the default). + =ROMAN(999;0) returns "CMXCIX". + =ROMAN(999;1) returns "LMVLIV". + =ROMAN(999;2) returns "XMIX". + =ROMAN(999;3) returns "VMIV". + =ROMAN(999;4) returns "IM". + =ROMAN(0) returns "" (empty text). + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_rounddown.xhp b/helpcontent2/source/text/scalc/01/func_rounddown.xhp new file mode 100644 index 000000000..bfe551627 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_rounddown.xhp @@ -0,0 +1,52 @@ + + + + + + + ROUNDDOWN function + /text/scalc/01/func_rounddown.xhp + + + + + + ROUNDDOWN function + numbers;rounding down + + +

ROUNDDOWN function

+
+ Rounds down a number while keeping a specified number of decimal digits. +
+ This function is equivalent to the TRUNC function. + + + + ROUNDDOWN(Number [; Count]) + +
+ Number: The number to be rounded down. + Count: Optional parameter that defines the number of decimal places to be kept. The default value is 0 (zero). + Use negative values for Count to round the integer part of the original Number. For example, -1 will round down the first integer number before the decimal separator, -2 will round down the two integer numbers before the decimal separator, and so forth. +
+ In %PRODUCTNAME, the Count parameter is optional, whereas in Microsoft Excel this parameter is mandatory. When an ODS file contains a call to ROUNDDOWN without the Count parameter and the file is exported to XLS or XLSX formats, the missing argument will automatically be added with value zero to maintain compatibility. + + =ROUNDDOWN(21.89) returns 21. Note that this example uses the default value for Count which is 0. + =ROUNDDOWN(103.37,1) returns 103.3. + =ROUNDDOWN(0.664,2) returns 0.66. + =ROUNDDOWN(214.2,-1) returns 210. Note the negative value for Count, which causes the first integer value before the decimal separator to be rounded towards zero. + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_roundsig.xhp b/helpcontent2/source/text/scalc/01/func_roundsig.xhp new file mode 100644 index 000000000..6e96d0a58 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_roundsig.xhp @@ -0,0 +1,48 @@ + + + + + + ROUNDSIG Function + /text/scalc/01/func_roundsig.xhp + + + +
+ + + ROUNDSIG Function + +

ROUNDSIG

+ Returns a number rounded to a specified number of significant decimal digits of its normalized floating point notation. +
+ + ROUNDSIG( Value; Digits ) + Value: the number to be rounded. + Digits: the number of decimal places to round. + + Digits must be an integer greater than 0. + + + + =ROUNDSIG(123.456789; 5) returns 123.46. + =ROUNDSIG(0.000123456789; 5) returns 0.00012346 + =ROUNDSIG(123456789012345; 2) returns 1.2E14 + =ROUNDSIG(123456789; 4) returns 123500000 or 123.5E6 + + + + ORG.LIBREOFFICE.ROUNDSIG +
+ See also ROUND, MROUND, ROUNDUP, ROUNDDOWN. +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_searchb.xhp b/helpcontent2/source/text/scalc/01/func_searchb.xhp new file mode 100644 index 000000000..41262c571 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_searchb.xhp @@ -0,0 +1,46 @@ + + + + + + + SEARCHB Function + /text/scalc/01/func_searchb.xhp + + + +
+ + + SEARCHB Function + search text;SEARCHB Function + +

SEARCHB

+ Returns the starting position of a given text, using byte positions (not case sensitive). +
+ + + SEARCHB(Find Text; Text [; Position]) + Find Text: The text or text expression to be found. + Text: the text in which the search is to be made. + Position: The position in the text where the search starts. + + + =SEARCHB("ᄫᄬ";"ᄩᄔᄕᄜᄝᄞᄠgᄢᄣᄫᄬᄭᄮᄯᄲᄶ";17) returns 20. +
+ + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_second.xhp b/helpcontent2/source/text/scalc/01/func_second.xhp new file mode 100644 index 000000000..0baee1eed --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_second.xhp @@ -0,0 +1,46 @@ + + + + + +SECOND +/text/scalc/01/func_second.xhp + + + +SECOND function + +

SECOND +

+Returns the second for the given time value. The second is given as an integer between 0 and 59. + + +SECOND(Number) + +Number, as a time value, is a decimal, for which the second is to be returned. + + +=SECOND(NOW()) returns the current second + +=SECOND(C4) returns 17 if contents of C4 = 12:20:17. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_skewp.xhp b/helpcontent2/source/text/scalc/01/func_skewp.xhp new file mode 100644 index 000000000..5a9cf51ae --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_skewp.xhp @@ -0,0 +1,52 @@ + + + + + + + SKEWP function + /text/scalc/01/func_skewp.xhp + + + +
+ + + skewness;population + SKEWP function + +

SKEWP

+Calculates the skewness of a distribution using the population of a random variable. + + + +SKEWP() + +The parameters should specify at least three values. + + + +SKEWP(2;3;1;6;8;5) returns 0.2329985562 +SKEWP(A1:A6) returns 0.2329985562, when the range A1:A6 contains {2;3;1;6;8;5} +
+
+SKEW +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_sum.xhp b/helpcontent2/source/text/scalc/01/func_sum.xhp new file mode 100644 index 000000000..04003fb75 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_sum.xhp @@ -0,0 +1,48 @@ + + + + + + + SUM Function + /text/scalc/01/func_sum.xhp + + + +
+ + + SUM function + adding;numbers in cell ranges + +

SUM

+ Adds a set of numbers. +
+ + + SUM() + + + + =SUM(2;3;4) returns 9. + =SUM(A1;A3;B5) calculates the sum of the three cells. + =SUM(A1:E10) calculates the sum of all cells in the A1 to E10 cell range. + A formula such as =SUM((A1:A40>=C1)*(A1:A40<C2)*B1:B40) may be entered as an array formula by pressing the Shift+Command+Ctrl+Enter keys instead of simply pressing the Enter key to finish entering the formula. The formula will then be shown in the Formula bar enclosed in braces and operates by multiplying corresponding elements of the arrays together and returning their sum. + Refer to the SUM wiki page for more details about this function. + +
+ + , + + +
+ + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/func_sumifs.xhp b/helpcontent2/source/text/scalc/01/func_sumifs.xhp new file mode 100644 index 000000000..924fa85b6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_sumifs.xhp @@ -0,0 +1,73 @@ + + + + + + + SUMIFS function + /text/scalc/01/func_sumifs.xhp + + + + +
+ + + SUMIFS function + sum;satisfying conditions + +

SUMIFS

+Returns the sum of the values of cells in a range that meets multiple criteria in multiple ranges. +
+ + +SUMIFS() + +Func_Range – required argument. It is a range of cells, a name of a named range or a label of a column or a row containing values for calculating the sum. + + + + + + + + + +

Simple usage

+=SUMIFS(B2:B6;B2:B6;">=20") +Calculates the sum of values of the range B2:B6 that are greater than or equal to 20. Returns 75, because the fifth row does not meet the criterion. +=SUMIFS(C2:C6;B2:B6;">=20";C2:C6;">70") +Calculates the sum of values of the range C2:C6 that are greater than 70 and correspond to cells of the B2:B6 range with values greater than or equal to 20. Returns 275, because the second and the fifth rows do not meet at least one criterion. +

Using regular expressions and nested functions

+=SUMIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6)) +Calculates the sum of values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 255, because the third and the fifth rows do not meet at least one criterion. +=SUMIFS(C2:C6;A2:A6;"pen.*";B2:B6;"<"&MAX(B2:B6)) +Calculates the sum of values of the range C2:C6 that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range except its maximum. Returns 65, because only second row meets all criteria. +

Reference to a cell as a criterion

+If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the SUMIFS function. For example, the above function can be rewritten as follows: +=SUMIFS(C2:C6;A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6)) +If E2 = pen, the function returns 65, because the link to the cell is substituted with its content. + +
+ +, + + + +, +, +, +, + + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_switch.xhp b/helpcontent2/source/text/scalc/01/func_switch.xhp new file mode 100644 index 000000000..18a7e65b4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_switch.xhp @@ -0,0 +1,47 @@ + + + + + + + SWITCH function + /text/scalc/01/func_switch.xhp + + + +
+ + + SWITCH function + +

SWITCH

+ SWITCH compares expression with value1 to valuen and returns the result belonging to the first value that equals expression. If there is no match and default_result is given, that will be returned. +
+ + + SWITCH(expression; value1; result1[; value2; result2][; ... ; [value127; result127][; default_result]]) + If you choose not to specify a default result, 127 value / result pairs may be entered as parameters. If you choose to include a default result at the end of the list of parameters, then only 126 value / result pairs may be entered. + expression is a text, numeric, logical or date input or reference to a cell. + value1, value2, ... is any value or reference to a cell. Each value must have a result given. + result1, result2, ... is any value or reference to a cell. + default_result: any value or reference to a cell that is returned when there is no match. + If no value equals expression and no default result is given, a #N/A error is returned. + + =SWITCH(MONTH(A3),1,"January",2,"February",3,"March","No match") returns "January" when A3 contains a date in January, "February" when A3 contains a date in February , etc... + + + + COM.MICROSOFT.SWITCH +
+ + IF +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_textjoin.xhp b/helpcontent2/source/text/scalc/01/func_textjoin.xhp new file mode 100644 index 000000000..a4111c925 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_textjoin.xhp @@ -0,0 +1,48 @@ + + + + + + + TEXTJOIN function + /text/scalc/01/func_textjoin.xhp + + + +
+ + + TEXTJOIN function + +

TEXTJOIN

+ Concatenates one or more strings, and uses delimiters between them. +
+ + TEXTJOIN( delimiter, skip_empty, String 1[; String 2][; … ;[String 253]] ) + delimiter is a text string and can be a range. + skip_empty is a logical argument. When set to FALSE or 0, empty strings will be taken into account and this may lead to adjacent delimiters in the returned string. When set to any other value (e.g. TRUE or 1), empty strings will be ignored. + String 1[; String 2][; … ;[String 253]] are strings, references to cells or to cell ranges of strings. + Ranges are traversed row by row (from top to bottom). + If delimiter is a range, the range need not be of the same size as the number of strings to be joined. + If there are more delimiters than strings to be joined, not all delimiters will be used. + If there are less delimiters than strings to be joined, the delimiters will be used again from the start. + + =TEXTJOIN(" "; 1; "Here"; "comes"; "the"; "sun") returns "Here comes the sun" with space character as delimiter and empty strings are ignored. + if A1:B2 contains "Here", "comes", "the", "sun" respectively, =TEXTJOIN("-";1;A1:B2) returns "Here-comes-the-sun" with dash character as delimiter and empty strings are ignored. + + + + COM.MICROSOFT.TEXTJOIN +
+ + CONCATENATE +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_time.xhp b/helpcontent2/source/text/scalc/01/func_time.xhp new file mode 100644 index 000000000..1aac1737c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_time.xhp @@ -0,0 +1,47 @@ + + + + + +TIME +/text/scalc/01/func_time.xhp + + + +TIME function + +

TIME +

+TIME returns the current time value from values for hours, minutes and seconds. This function can be used to convert a time based on these three elements to a decimal time value. + + +TIME(Hour; Minute; Second) +Use an integer to set the Hour. +Use an integer to set the Minute. +Use an integer to set the Second. + + +=TIME(0;0;0) returns 00:00:00 + +=TIME(4;20;4) returns 04:20:04 +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_timevalue.xhp b/helpcontent2/source/text/scalc/01/func_timevalue.xhp new file mode 100644 index 000000000..87bd8da08 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_timevalue.xhp @@ -0,0 +1,46 @@ + + + + + + TIMEVALUE + /text/scalc/01/func_timevalue.xhp + + + + + TIMEVALUE function + + +

TIMEVALUE

+ TIMEVALUE returns the internal time number from a text enclosed by quotes and which may show a possible time entry format. + + The internal number indicated as a decimal is the result of the date system used under $[officename] to calculate date entries. + If the text string also includes a year, month, or day, TIMEVALUE only returns the fractional part of the conversion. + + TIMEVALUE("Text") + Text is a valid time expression and must be entered in quotation marks. + + =TIMEVALUE("4PM") returns 0.67. When formatting in time format HH:MM:SS, you then get 16:00:00. + =TIMEVALUE("24:00") returns 0. If you use the HH:MM:SS time format, the value is 00:00:00. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_today.xhp b/helpcontent2/source/text/scalc/01/func_today.xhp new file mode 100644 index 000000000..e4214238d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_today.xhp @@ -0,0 +1,44 @@ + + + + + +TODAY +/text/scalc/01/func_today.xhp + + + +TODAY function + +

TODAY +

+Returns the current computer system date. The value is updated when you reopen the document or modify the values of the document. + + + +TODAY() + TODAY is a function without arguments. + + +TODAY() returns the current computer system date. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_trunc.xhp b/helpcontent2/source/text/scalc/01/func_trunc.xhp new file mode 100644 index 000000000..22b58a278 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_trunc.xhp @@ -0,0 +1,54 @@ + + + + + + + TRUNC function + /text/scalc/01/func_trunc.xhp + + + + + + TRUNC function + decimal places;cutting off + numbers;truncate + + +

TRUNC function

+
+ Truncates a number while keeping a specified number of decimal digits. +
+ This function is equivalent to the ROUNDDOWN function. +
+ The rounding method used by this function is known as rounding towards zero. The resulting number will always be smaller than or equal to the original number. +
+ + + TRUNC(Number [; Count]) + +
+ Number: The number to be truncated. + Count: Optional parameter that defines the number of decimal places to be kept. The default value is 0 (zero). + Use negative values for Count to round the integer part of the original Number. For example, -1 will round down the first integer number before the decimal separator, -2 will round down the two integer numbers before the decimal separator, and so forth. +
+ + =TRUNC(21.89) returns 21. Note that this example uses the default value for Count which is 0. + =TRUNC(103.37,1) returns 103.3. + =TRUNC(0.664,2) returns 0.66. + =TRUNC(214.2,-1) returns 210. Note the negative value for Count, which causes the first integer value before the decimal separator to be rounded towards zero. + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_value.xhp b/helpcontent2/source/text/scalc/01/func_value.xhp new file mode 100644 index 000000000..2293c1a10 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_value.xhp @@ -0,0 +1,47 @@ + + + + + + + VALUE Function + /text/scalc/01/func_value.xhp + + + +
+ + + VALUE function + text functions;convert text to numeric value + +

VALUE

+ Converts the string representation of a number to numeric form. If the supplied string is a valid date, time, or date-time, the corresponding date-time serial number is returned. +
+ + VALUE(Text) + Text: A string (in quotation marks), a number, or a reference to a cell containing one of those types, that contains the value to be converted. + If the Text argument is a string representing a date, time, currency or a numeric value with decimal and thousands separators, the string must comply with current locale settings. + + =VALUE("1234") returns the numeric value 1234. + =VALUE("+1,234.567") returns 1234.567 (considering en-US locale). Note that the "+" sign could have been omitted. + =VALUE("$100") returns 100 (considering en-US locale). Note that the currency prefix must match the current locale settings. + =VALUE("50%") returns 0.5. Note that the character "%" causes the numeric part to be divided by 100. + =VALUE("07/30/2021") returns 44407 (considering en-US locale) which is the date-time sequence number corresponding to the specified date. + =VALUE("09:20:25") returns 0.389178240740741 which is the date-time sequence number corresponding to the specified time value. + Refer to the VALUE wiki page for more details about this function. + +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_webservice.xhp b/helpcontent2/source/text/scalc/01/func_webservice.xhp new file mode 100644 index 000000000..cd1df5c87 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_webservice.xhp @@ -0,0 +1,82 @@ + + + + + + URI Functions + /text/scalc/01/func_webservice.xhp + + + +
+ + WEBSERVICE function + + +
+

WEBSERVICE

+ Get some web content from a URI. +
+ + WEBSERVICE(URI) + URI: URI text of the web service. + + =WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss") + Returns the web page content of "https://wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss". + + + + COM.MICROSOFT.WEBSERVICE +
+
+ + + FILTERXML function + +
+

FILTERXML

+ Apply a XPath expression to a XML document. +
+ + FILTERXML(XML Document; XPath expression) + XML Document (required): String containing a valid XML stream. + XPath expression (required): String containing a valid XPath expression. + + =FILTERXML(WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss");"//lastBuildDate") + Returns information on the last build date of the wiki. + + + + COM.MICROSOFT.FILTERXML +
+
+ + + ENCODEURL function + +
+

ENCODEURL

+ Returns a URL-encoded string. +
+ Use this function to transform text with symbols of national alphabets (for example accented characters, non-ASCII alphabets or Asian words) to a string of URL-standard symbols. + + ENCODEURL(Text) + Text: String to encode to a sequence of URL-standard symbols. + + If cell A1 contains the Cyrillic text "автомобиль", =ENCODEURL(A1) returns %D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C (the word "автомобиль" means car in Russian). + If cell B1 contains the text "車", =ENCODEURL(B1) returns %E8%BB%8A ("車" means car in Japanese). + + + + COM.MICROSOFT.ENCODEURL +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_weekday.xhp b/helpcontent2/source/text/scalc/01/func_weekday.xhp new file mode 100644 index 000000000..f000d5fe7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weekday.xhp @@ -0,0 +1,151 @@ + + + + + + + WEEKDAY + /text/scalc/01/func_weekday.xhp + + + + + + + WEEKDAY function + + + + +

WEEKDAY

+Returns the day of the week for the given date value. The day is returned as an integer between 1 (Sunday) and 7 (Saturday) if no type or type=1 is specified. For other types, see the table below. + + +WEEKDAY(Number [; Type]) + Number, as a date value, is a decimal for which the weekday is to be returned. + Type is optional and determines the type of calculation. + + + + + Type + + + Weekday number returned + + + + + 1 or omitted + + + 1 (Sunday) through 7 (Saturday). For compatibility with Microsoft Excel. + + + + + 2 + + + 1 (Monday) through 7 (Sunday). + + + + + 3 + + + 0 (Monday) through 6 (Sunday) + + + + + 11 + + + 1 (Monday) through 7 (Sunday). + + + + + 12 + + + 1 (Tuesday) through 7 (Monday). + + + + + 13 + + + 1 (Wednesday) through 7 (Tuesday). + + + + + 14 + + + 1 (Thursday) through 7 (Wednesday). + + + + + 15 + + + 1 (Friday) through 7 (Thursday). + + + + + 16 + + + 1 (Saturday) through 7 (Friday). + + + + + 17 + + + 1 (Sunday) through 7 (Saturday). + + +
+ +These values apply only to the standard date format that you select under %PRODUCTNAME - Preferences +Tools - Options- %PRODUCTNAME Calc - Calculate. + + + +=WEEKDAY("2000-06-14") returns 4 (the Type parameter is missing, therefore the standard count is used. The standard count starts with Sunday as day number 1. June 14, 2000 was a Wednesday and therefore day number 4). +=WEEKDAY("1996-07-24";2) returns 3 (the Type parameter is 2, therefore Monday is day number 1. July 24, 1996 was a Wednesday and therefore day number 3). +=WEEKDAY("1996-07-24";1) returns 4 (the Type parameter is 1, therefore Sunday is day number 1. July 24, 1996 was a Wednesday and therefore day number 4). +=WEEKDAY("2017-05-02";14) returns 6 (the Type parameter is 14, therefore Thursday is day number 1. May 2, 2017 was a Tuesday and therefore day number 6) +=WEEKDAY(NOW()) returns the number of the current day. +To obtain a function indicating whether a day in A1 is a business day, use the IF and WEEKDAY functions as follows:
IF(WEEKDAY(A1;2)<6;"Business day";"Weekend") +
+ +
+ + + diff --git a/helpcontent2/source/text/scalc/01/func_weeknum.xhp b/helpcontent2/source/text/scalc/01/func_weeknum.xhp new file mode 100644 index 000000000..99a089af3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weeknum.xhp @@ -0,0 +1,184 @@ + + + + + +WEEKNUM +/text/scalc/01/func_weeknum.xhp + + + +WEEKNUM function + +

WEEKNUM +

+WEEKNUM calculates the week number of the year for the internal date value as defined in ODF OpenFormula and compatible with other spreadsheet applications. +Supported are two week numbering systems: + + + + System + + + Description + + + + + System 1 + + + The week containing January 1 is the first week of the year, and is numbered week 1. + + + + + System 2 + + + The week containing the first Thursday of the year is the first week of the year, and is numbered week 1. That means that week number 1 of any year is the week that contains January 4th. ISO 8601 defines this system and that the week starts on Monday. + + +
+ + +WEEKNUM(Number [; Mode]) + +Number is the internal date number. + +Mode sets the start of the week and the week numbering system. This parameter is optional, if omitted the default value is 1. + + + + System + + + Mode + + + Day of the week + + + + + System 1 + + + 1 + + + Sunday + + + + + 2 + + + Monday + + + + + 11 + + + Monday + + + + + 12 + + + Tuesday + + + + + 13 + + + Wednesday + + + + + 14 + + + Thursday + + + + + 15 + + + Friday + + + + + 16 + + + Saturday + + + + + 17 + + + Sunday + + + + + System 2 + + + 21 + + + Monday (ISO 8601) + + + + + 150 + + + (ISO 8601, for interoperability with Gnumeric) + + +
+ + + +=WEEKNUM(DATE(1995;1;1);1) returns 1 +=WEEKNUM(DATE(1995;1;1);2) returns 1. Using System 1, the week containing January 1 is the first week of the year. +=WEEKNUM(DATE(1995;1;1);21) returns 52. Week 1 starts on Monday, 1995-01-02. +=WEEKNUM(DATE(1999;1;1);21) returns 53. Week 1 starts on Monday, 1999-01-04. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_weeknum_ooo.xhp b/helpcontent2/source/text/scalc/01/func_weeknum_ooo.xhp new file mode 100644 index 000000000..28519d22a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weeknum_ooo.xhp @@ -0,0 +1,55 @@ + + + + + +WEEKNUM_OOO +/text/scalc/01/func_weeknum_ooo.xhp + + + +WEEKNUM_OOO function + +

WEEKNUM_OOO +

+WEEKNUM_OOO calculates the week number of the year for the internal date value. +This function exists for interoperability with %PRODUCTNAME releases older than 5.1.0 and OpenOffice.org. It calculates week numbers for a week numbering system in that week number 1 is the week that contains the January 4th. This function does not provide interoperability with other spreadsheet applications. For new documents use the WEEKNUM or ISOWEEKNUM function instead. + +WEEKNUM_OOO(Number; Mode) + +Number is the internal date number. + +Mode sets the start of the week and the calculation type. +1 = Sunday +2 = Monday (ISO 8601) +any other value = Monday (ISO 8601) + + + +=WEEKNUM_OOO(DATE(1995;1;1);1) returns 1 +=WEEKNUM_OOO(DATE(1995;1;1);2) returns 52. Week 1 starts on Monday, 1995-01-02. + + + +ORG.LIBREOFFICE.WEEKNUM_OOO +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_weeknumadd.xhp b/helpcontent2/source/text/scalc/01/func_weeknumadd.xhp new file mode 100644 index 000000000..57f838d9a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weeknumadd.xhp @@ -0,0 +1,47 @@ + + + + + +WEEKNUM_EXCEL2003 +/text/scalc/01/func_weeknumadd.xhp + + + +WEEKNUM_EXCEL2003 function + +

WEEKNUM_EXCEL2003 +

+The result indicates the number of the calendar week for a date. +The WEEKNUM_EXCEL2003 function is designed to calculate week numbers exactly as Microsoft Excel 2003 did. Use the WEEKNUM function for ODF OpenFormula and Excel 2010 compatibility, or ISOWEEKNUM function when you just need ISO 8601 week numbers. In releases prior to $[officename] 5.1 WEEKNUM_EXCEL2003 was named WEEKNUM_ADD. + +WEEKNUM_EXCEL2003(Date; ReturnType) + +Date is the date within the calendar week. + +ReturnType is 1 for week beginning on a Sunday, 2 for week beginning on a Monday. + +In which week number does 2001-12-24 fall? + +=WEEKNUM_EXCEL2003(DATE(2001;12;24);1) returns 52. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_workday.intl.xhp b/helpcontent2/source/text/scalc/01/func_workday.intl.xhp new file mode 100644 index 000000000..f41a62d87 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_workday.intl.xhp @@ -0,0 +1,66 @@ + + + + + + + WORKDAY.INTL + /text/scalc/01/func_workday.intl.xhp + + + +
+ + WORKDAY.INTL function + + + + +

WORKDAY.INTL

+Returns the date calculated from a start date with a specific number of work days, before or after the start date. The calculation can include week-ends and holidays as non-working days. +
+ +WORKDAY.INTL(StartDate; Days [; Weekend [; Holidays]]) +StartDate: is the date from when the calculation is carried out. +Days is the number of workdays. Positive value for a result after the start date, negative value for a result before the start date. + + + + +What date comes 20 workdays after December 13, 2016? Enter the start date in C3 and the number of workdays in D3. +The weekend parameter (number) may be left blank or defined as 1 for default weekend (non-working days) – Saturday and Sunday. +Cells F3 to J3 contain five (5) holidays for Christmas and New Year in date format: December 24, 2016; December 25, 2016; December 26, 2016; December 31, 2016; and January 1, 2017. +=WORKDAY.INTL(C3;D3;;F3:J3) returns January 11, 2017 in the result cell, say D6 (use date format for the cell). +To define Friday and Saturday as weekend days, use the weekend parameter 7. +=WORKDAY.INTL(C3;D3;7;F3:J3) returns January 15, 2017 with weekend parameter 7. +To define Sunday only the weekend day, use the weekend parameter 11. +=WORKDAY.INTL(C3;D3;11;F3:J3) returns January 9, 2017. +Alternatively, use the weekend string "0000001" for Sunday only weekend. +=WORKDAY.INTL(C3;D3;"0000001";F3:J3) returns January 9, 2017. +The function can be used without the two optional parameters – Weekday and Holidays – by leaving them out: +=WORKDAY.INTL(C3;D3) gives the result: January 10, 2017. + + + +COM.MICROSOFT.WORKDAY.INTL +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_workday.xhp b/helpcontent2/source/text/scalc/01/func_workday.xhp new file mode 100644 index 000000000..95b1f9510 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_workday.xhp @@ -0,0 +1,57 @@ + + + + + +WORKDAY +/text/scalc/01/func_workday.xhp + + + +WORKDAY function + + +

WORKDAY

+ The result is a date number that can be formatted as a date. You then see the date of a day that is a certain number of workdays away from the start date. + + +WORKDAY(StartDate; Days [; Holidays]) + +StartDate is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation. + +Days is the number of workdays. Positive value for a result after the start date, negative value for a result before the start date. + +Holidays is a list of optional holidays. These are non-working days. Enter a cell range in which the holidays are listed individually. + + + + +What date came 17 workdays after 1 December 2001? Enter the start date "2001-12-01" in C3 and the number of workdays in D3. Cells F3 to J3 contain the following Christmas and New Year holidays: "2001-12-24", "2001-12-25", "2001-12-26", "2001-12-31", "2002-01-01". +=WORKDAY(C3;D3;F3:J3) returns 2001-12-28. Format the serial date number as a date, for example in the format YYYY-MM-DD.UFI: fixed #i30213# +
+ + + +Date functions +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_year.xhp b/helpcontent2/source/text/scalc/01/func_year.xhp new file mode 100644 index 000000000..c2fe1b635 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_year.xhp @@ -0,0 +1,50 @@ + + + + + +YEAR +/text/scalc/01/func_year.xhp + + + +YEAR function + +

YEAR +

+Returns the year as a number according to the internal calculation rules. + + +YEAR(Number) + +Number shows the internal date value for which the year is to be returned. + + +=YEAR(1) returns 1899 + +=YEAR(2) returns 1900 + +=YEAR(33333.33) returns 1991 +=YEAR(DATEVALUE('2010-09-28')) returns 2010. + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/func_yearfrac.xhp b/helpcontent2/source/text/scalc/01/func_yearfrac.xhp new file mode 100644 index 000000000..52cb40c5c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_yearfrac.xhp @@ -0,0 +1,100 @@ + + + + + +YEARFRAC +/text/scalc/01/func_yearfrac.xhp + + + +YEARFRAC function + + +

YEARFRAC

+The result is the number of the years (including fractional part) between StartDate and EndDate. + + +YEARFRAC(StartDate; EndDate [; Basis]) + +StartDate and EndDate are two date values. +
+ +Basis (optional) is chosen from a list of options and indicates how the year is to be calculated. + + + +Basis + + +Calculation + + + + +0 or missing + + +US method (NASD), 12 months of 30 days each + + + + + 1 + + +Exact number of days in months, exact number of days in year + + + + + 2 + + +Exact number of days in month, year has 360 days + + + + + 3 + + +Exact number of days in month, year has 365 days + + + + + 4 + + +European method, 12 months of 30 days each + + +
+
+ + + +What fraction of the year 2008 lies between 2008-01-01 and 2008-07-01? +=YEARFRAC("2008-01-01"; "2008-07-01";0) returns 0.50. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/live_data_stream.xhp b/helpcontent2/source/text/scalc/01/live_data_stream.xhp new file mode 100644 index 000000000..774ec4e0f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/live_data_stream.xhp @@ -0,0 +1,76 @@ + + + + + + Live Data Stream + /text/scalc/01/live_data_stream.xhp + + + + + + + Data Stream;Live data stream + Data Stream;Streams + +
+

Live Data Stream

+ Create live data streams for spreadsheets. +
+
+ Choose Data – Streams +
+ + + Data streaming is the continuous flow of data generated by various sources. In %PRODUCTNAME Calc, data streams can be processed, stored, analyzed, and acted upon as it's generated in real-time. + Some real-life examples of streaming data include use cases in every industry, including real-time stock trades, up-to-the-minute retail inventory management, social media feeds, multiplayer game interactions, and ride-sharing apps. + +

Source stream

+

URL

+ URL of the source document in the local file system or internet. + +

Interpret stream data as

+ + + value1,value2,...,valueN, and fill into range: + + + address,value: + + +

Empty lines trigger UI refresh

+ +

When new data arrives

+ There are three features of this option: + + + Move existing data down: the existing data is moved down in index and the empty space is filled by arriving data. In short, we deal in fix range of indexes. + + + Move the range down: the arriving data is appended at the end of existing data and range of indexes to be processed is shifted. + + + Overwrite existing data: the arriving data overrides the existing data. + + +

Maximal Amount of Rows

+ Limit the maximum numbers of rows to a specified value or leave undefined, but limited to the %PRODUCTNAME Calc row limit. + + diff --git a/helpcontent2/source/text/scalc/01/recalculate_hard.xhp b/helpcontent2/source/text/scalc/01/recalculate_hard.xhp new file mode 100644 index 000000000..296a3fd1e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/recalculate_hard.xhp @@ -0,0 +1,37 @@ + + + + + + + Recalculate hard + /text/scalc/01/recalculate_hard.xhp + + + + + + calculate;recalculate hard + formulas;recalculate hard + calculate;force recalculation + formulas;force recalculation + non volatile functions;force recalculation + cell contents;force recalculation + +
+

Recalculate Hard

+ Recalculates all formulas in the document, including Add-In functions and non-volatile functions. +
+
+ +
+The Recalculate Hard command forces recalculation of all formula cells of the spreadsheet document, including explicit non-volatile functions, even if no new input event exist. Examples of explicit non-volatile functions are RAND.NV and RANDBETWEEN.NV. + + diff --git a/helpcontent2/source/text/scalc/01/shared_spreadsheet.xhp b/helpcontent2/source/text/scalc/01/shared_spreadsheet.xhp new file mode 100644 index 000000000..c93c059d1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/shared_spreadsheet.xhp @@ -0,0 +1,47 @@ + + + + + + + Sharing Spreadsheets + /text/scalc/01/shared_spreadsheet.xhp + + + + + share spreadsheet + spreadsheet;collaboration + spreadsheet;share + +
+ +

Share Spreadsheet

+ Sharing a spreadsheet allows several users to open the same file for editing at the same time. +
+
+ +
+ The spreadsheet needs to be on a shared drive, server, website, or similar. Some conditions must be met on operating systems with user permission management: + + + The shared file needs to reside in a location which is accessible by all collaborators. + + + The file permissions for both the document and the corresponding lock file need to be set so that all collaborators can create, delete, and change the files. + + + In order to correctly identify the changes, each collaborator should enter their name in %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME - User Data on the Menu bar. + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/solver.xhp b/helpcontent2/source/text/scalc/01/solver.xhp new file mode 100644 index 000000000..1aa2fa6a3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/solver.xhp @@ -0,0 +1,153 @@ + + + + + + + Solver + /text/scalc/01/solver.xhp + + + + + +
+ + goal seeking;solver + what if operations;solver + back-solving + solver + mathematical programming;solver for Calc + mathematical optimization;solver for Calc + operations research;solver for Calc + + + + + + +

Solver

+Opens the Solver dialog. A solver allows you to solve mathematical problems with multiple unknown variables and a set of constraints on the variables by goal-seeking methods. +
+ +
+ +
+target cell +

Solver settings

+ +Solver settings are not saved to the file by %PRODUCTNAME Calc. Closing and reopening the file will reset the solver dialog to default settings. + + +

Target Cell

+Enter or click the cell reference of the target cell. This field takes the address of the cell whose value is to be optimized. + +

Optimize results to

+ + + + + + + Maximum: Try to solve the equation for a maximum value of the target cell. + + + Minimum: Try to solve the equation for a minimum value of the target cell. + + + Value of: Try to solve the equation to approach a given value of the target cell. + Enter the value or a cell reference in the text field. + + + +

By Changing Cells

+ +Enter the cell range that can be changed. These are the variables of the equations. + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Limiting Conditions

+Add the set of constraints for the mathematical problem. Each constraint is represented by a cell reference (a variable), an operator, and a value. + + + Cell reference: Enter a cell reference of the variable. + Click the Shrink button to shrink or restore the dialog. You can click or select cells in the sheet. You can enter a cell reference manually in the input box. + + + Operator: Select an operator from the list. Use Binary operator to restrict your variable to 0 or 1. Use the Integer operator to restrict your variable to take only integer values (no decimal part). + + + Value: Enter a value or a cell reference. This field is ignored when the operator is Binary or Integer. + + + Remove button: Click to remove the row from the list. Any rows from below this row move up. + + +You can set multiple conditions for a variable. For example, a variable in cell A1 that must be an integer less than 10. In that case, set two limiting conditions for A1. + +

Options

+ + +Opens the Solver Options dialog. +The Solver Options dialog let you select the different solver algorithms for either linear and non-linear problems and set their solving parameters. +

Solve

+solve button + +Click to solve the problem with the current settings. The dialog settings are retained until you close the current document. + +

To solve equations with the solver

+The goal of the solver process is to find those variable values of an equation that result in an optimized value in the target cell, also named the "objective". You can choose whether the value in the target cell should be a maximum, a minimum, or approaching a given value. +The initial variable values are inserted in a rectangular cell range that you enter in the By changing cells box. +You can define a series of limiting conditions that set constraints for some cells. For example, you can set the constraint that one of the variables or cells must not be bigger than another variable, or not bigger than a given value. You can also define the constraint that one or more variables must be integers (values without decimals), or binary values (where only 0 and 1 are allowed). +

Using Non-Linear solvers

+Regardless whether you use DEPS or SCO, you start by going to Tools - Solver and set the Cell to be optimized, the direction to go (minimization, maximization) and the cells to be modified to reach the goal. Then you go to the Options and specify the solver to be used and if necessary adjust the according parameters. +There is also a list of constraints you can use to restrict the possible range of solutions or to penalize certain conditions. However, in case of the evolutionary solvers DEPS and SCO, these constraints are also used to specify bounds on the variables of the problem. Due to the random nature of the algorithms, it is highly recommended to do so and give upper (and in case "Assume Non-Negative Variables" is turned off also lower) bounds for all variables. They don't have to be near the actual solution (which is probably unknown) but should give a rough indication of the expected size (0 ≤ var ≤ 1 or maybe -1000000 ≤ var ≤ 1000000). +Bounds are specified by selecting one or more variables (as range) on the left side and entering a numerical value (not a cell or a formula) on the right side. That way you can also choose one or more variables to be Integer or Binary only. +
+ + + Wiki page on solvers and theirs algorithms +
+ + diff --git a/helpcontent2/source/text/scalc/01/solver_options.xhp b/helpcontent2/source/text/scalc/01/solver_options.xhp new file mode 100644 index 000000000..e4e2291d4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/solver_options.xhp @@ -0,0 +1,80 @@ + + + + + + + Solver Options + /text/scalc/01/solver_options.xhp + + + + + + + + + solver for Calc;options + +

Solver Options

+ +Use the Options dialog to configure the solver engine. + +
+ +
+ +Click OK to accept the changes and to go back to the Solver dialog. +

Solver engine

+ +Select a solver engine. The listbox is disabled if only one solver engine is installed. +You can install more solver engines as extensions, if available. Open Tools - Extension Manager and browse to the Extensions web site to search for extensions. + +

Settings

+Configure the current solver. In the Settings box, check all settings that you want to use for the current goal seeking operation. If the current option offers different values, the Edit button is enabled. Click Edit to open a dialog where you can change the value. + + + + + + + + + + + + + + +

Edit

+ +If the current entry in the Settings listbox allows you to edit a value, you can click the Edit button. A dialog opens where you can change the value. +

Edit settings spin box

+ + + + +Enter or change the value of the selected setting. +
+ + + Wiki page on non-linear solvers and theirs algorithms +
+ + diff --git a/helpcontent2/source/text/scalc/01/solver_options_algo.xhp b/helpcontent2/source/text/scalc/01/solver_options_algo.xhp new file mode 100644 index 000000000..486212284 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/solver_options_algo.xhp @@ -0,0 +1,386 @@ + + + + + + + + Options + /text/scalc/01/solver_options_algo.xhp + + + + + Solver for Nonlinear Problems;Options + solver for Calc; DEPS evolutionary algorithm + solver for Calc; SCO evolutionary algorithm + solver for Calc; linear solver + solver for Calc; CoinMP linear solver + solver for Calc; swarm non-linear solver + + +

Solver Algorithms Options

+ +

DEPS Evolutionary Algorithm

+ DEPS consists of two independent algorithms: Differential Evolution and Particle Swarm Optimization. Both are especially suited for numerical problems, such as nonlinear optimization, and are complementary to each other in that they even out their others shortcomings. + + + + + + + + + + + + Agent Switch Rate + + + Specifies the probability for an individual to choose the Differential Evolution strategy. + + + + + + + + + + + + + DE: Crossover Probability + + + Defines the probability of the individual being combined with the globally best point. If crossover is not used, the point is assembled from the own memory of the individual. + + + + + DE: Scaling Factor + + + During crossover, the scaling factor decides about the “speed” of movement. + + + + + Learning Cycles + + + Defines the number of iterations, the algorithm should take. In each iteration, all individuals make a guess on the best solution and share their knowledge. + + + + + PS: Cognitive Constant + + + Sets the importance of the own memory (in particular the best reached point so far). + + + + + PS: Constriction Coefficient + + + Defines the speed at which the particles/individuals move towards each other. + + + + + PS: Mutation Probability + + + Defines the probability, that instead of moving a component of the particle towards the best point, it randomly chooses a new value from the valid range for that variable. + + + + + PS: Social Constant + + + Sets the importance of the global best point between all particles/individuals. + + + + + Show Enhanced Solver Status + + + If enabled, an additional dialog is shown during the solving process which gives information about the current progress, the level of stagnation, the currently best known solution as well as the possibility, to stop or resume the solver. + + + + + Size of Swarm + + + Defines the number of individuals to participate in the learning process. Each individual finds its own solutions and contributes to the overall knowledge. + + + + + Stagnation Limit + + + If this number of individuals found solutions within a close range, the iteration is stopped and the best of these values is chosen as optimal. + + + + + Stagnation Tolerance + + + Defines in what range solutions are considered “similar”. + + + + + Use ACR Comparator + + +
+ If disabled (default), the BCH Comparator is used. It compares two individuals by first looking at their constraint violations and only if those are equal, it measures their current solution. + If enabled, the ACR Comparator is used. It compares two individuals dependent on the current iteration and measures their goodness with knowledge about the libraries worst known solutions (in regard to their constraint violations). +
+ + + + + Use Random Starting Point + + + If enabled, the library is simply filled up with randomly chosen points. + If disabled, the currently present values (as given by the user) are inserted in the library as reference point. + + + + + Variable Bounds Guessing + + + If enabled (default), the algorithm tries to find variable bounds by looking at the starting values. + + + + + Variable Bounds Threshold + + + When guessing variable bounds, this threshold specifies, how the initial values are shifted to build the bounds. For an example how these values are calculated, please refer to the Manual in the Wiki. + + +
+ +

SCO Evolutionary Algorithm

+ Social Cognitive Optimization takes into account the human behavior of learning and sharing information. Each individual has access to a common library with knowledge shared between all individuals. + + + + + + + + + + + + + + + + + + + + Learning Cycles + + + Defines the number of iterations, the algorithm should take. In each iteration, all individuals make a guess on the best solution and share their knowledge. + + + + + + + + + + + + + Size of Library + + + Defines the amount of information to store in the public library. Each individual stores knowledge there and asks for information. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

%PRODUCTNAME Linear Solver and CoinMP Linear solver

+ + + + Setting + + + Description + + + + + Assume variables as integers + + + Mark to force variables to be integers only. + + + + + Assume variables as non negative + + + Mark to force variables to be positive only. + + + + + Epsilon level + + + Epsilon level. Valid values are in range 0 (very tight) to 3 (very loose). Epsilon is the tolerance for rounding values to zero. + + + + + Limit branch-and-bound depth + + + Specifies the maximum branch-and-bound depth. A positive value means that the depth is absolute. A negative value means a relative branch-and-bound depth limit. + + + + + Solver time limit + + + Sets the maximum time for the algorithm to converge to a solution. + + +
+

%PRODUCTNAME Swarm Non-Linear Solver (Experimental)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Swarm algorithm + + + Set the swarm algorithm. 0 for differential evolution and 1 for particle swarm optimization. Default is 0. + + +
+
+ + + Wiki page on non-linear solvers and theirs algorithms + lp_solve reference guide in sourceforge.net +
+ + diff --git a/helpcontent2/source/text/scalc/01/sparklines.xhp b/helpcontent2/source/text/scalc/01/sparklines.xhp new file mode 100644 index 000000000..70d9c1b0e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/sparklines.xhp @@ -0,0 +1,91 @@ + + + + + + + Sparklines + /text/scalc/01/sparklines.xhp + + + + + + + +sparklines + +
+

Sparklines

+ Sparklines are small data charts displayed inside a cell. +
+ Sparklines are defined for one cell, but multiple sparklines can be joined together into a group. The group shares the same properties for rendering the sparkline. The unique data that is defined only for one sparkline is the data range, that a sparkline will use for rendering. +
+ Choose Insert – Sparklines +
+

Data

+ Input range: enter the cell range of the data. Use the shrink button to select the data range with the mouse. + Output range: select the cell range to receive the sparkline. Use the shrink button to select the cell range with the mouse. +

Properties

+ Type: select the sparkline type in the drop-down list. Choices are: + + + Line: draws a line between data values. + + + Column: draws a bar for each data value. + + + Stacked: also known as win/loss. Displays equally sized bars indicating positive and negative values. + + + Line width: enter the line width number manually or use the spin button. + Display empty cells as: choices are available in the drop-down list: + + + Gap: the missing data is not displayed. The line type discontinues in the gap and the column is not displayed. + + + Zero: the missing data is displayed as value zero. + + + Span: for line type only, draws a continuous line connecting the previous value to the next value. + + + Display hidden: check to show all columns or stacks in the range even when the data is in hidden cells. If unchecked, the hidden data is ignored. + Right-to-left: check to display the sparklines reverse order of the data. +

Colors

+ Series: select the main color for the sparklines. + Negative points: check and select the color for negative points. + High points: check and select the color for high points. + Low points: check and select the color for low points. + Marker: check and select the color for data points (line type only). + First point: check and select the color for first point. + Last point: check and select the color for last point. + +

Axes

+ Display X axis: check to show the X axis for sparklines. + Vertical minimum, Vertical maximum: check to set the minimum (maximum) value for the Y axis. Select one of following: + + + Individual: sets automatically the minimum (maximum) value for each sparkline based on the sparkline data range values. + + + Group: sets the minimum (maximum) value based on the lower and higher values found in the group of sparklines. + + + Custom: enter the minimum (maximum) value for the sparkline group. Enter the minimum (maximum) values or use the spin buttons. + + +
+ Developer blog post on sparklines +
+ + diff --git a/helpcontent2/source/text/scalc/01/stat_data.xhp b/helpcontent2/source/text/scalc/01/stat_data.xhp new file mode 100644 index 000000000..7556d0d10 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/stat_data.xhp @@ -0,0 +1,1337 @@ + + + + + + + Data + /text/scalc/01/stat_data.xhp + + + + + +
+

Data

+ Input Range: The reference of the range of the data to analyze. + Results to: The reference of the top left cell of the range where the results will be displayed. +
+ +
+

Grouped By

+ Select whether the input data has columns or rows layout. +
+ +
+ + + + + + + + + + + + + +
+ +
+ + + The following data will be used as example + + + + + + + A + + + B + + + C + + + + + 1 + + + Maths + + + Physics + + + Biology + + + + + 2 + + + 47 + + + 67 + + + 33 + + + + + 3 + + + 36 + + + 68 + + + 42 + + + + + 4 + + + 40 + + + 65 + + + 44 + + + + + 5 + + + 39 + + + 64 + + + 60 + + + + + 6 + + + + + 38 + + + 43 + + + + + 7 + + + 47 + + + 84 + + + 62 + + + + + 8 + + + 29 + + + 80 + + + 51 + + + + + 9 + + + 27 + + + 49 + + + 40 + + + + + 10 + + + 57 + + + 49 + + + 12 + + + + + 11 + + + 56 + + + 33 + + + 60 + + + + + 12 + + + 57 + + + + + + + + + 13 + + + 26 + + + + + + +
+ +
+ +
+ + + The following table has two time series, one representing an impulse function at time t=0 and the other an impulse function at time t=2. + + + + + + + A + + + B + + + + + 1 + + + 1 + + + 0 + + + + + 2 + + + 0 + + + 0 + + + + + 3 + + + 0 + + + 1 + + + + + 4 + + + 0 + + + 0 + + + + + 5 + + + 0 + + + 0 + + + + + 6 + + + 0 + + + 0 + + + + + 7 + + + 0 + + + 0 + + + + + 8 + + + 0 + + + 0 + + + + + 9 + + + 0 + + + 0 + + + + + 10 + + + 0 + + + 0 + + + + + 11 + + + 0 + + + 0 + + + + + 12 + + + 0 + + + 0 + + + + + 13 + + + 0 + + + 0 + + +
+ +
+ +
+ + + The following table has two data sets. + + + + + + + A + + + B + + + + + 1 + + + 28 + + + 19 + + + + + 2 + + + 26 + + + 13 + + + + + 3 + + + 31 + + + 12 + + + + + 4 + + + 23 + + + 5 + + + + + 5 + + + 20 + + + 34 + + + + + 6 + + + 27 + + + 31 + + + + + 7 + + + 28 + + + 31 + + + + + 8 + + + 14 + + + 12 + + + + + 9 + + + 4 + + + 24 + + + + + 10 + + + 0 + + + 23 + + + + + 11 + + + 2 + + + 19 + + + + + 12 + + + 8 + + + 10 + + + + + 13 + + + 9 + + + 33 + + +
+ +
+ +
+ + + The following table has samples of a physical phenomenon taken in 1 second interval. + + + + + + A + + + B + + + + + 1 + + + Time + + + Measurement + + + + + 2 + + + 1 + + + 2.7 + + + + + 3 + + + 2 + + + 4.0 + + + + + 4 + + + 3 + + + 4.4 + + + + + 5 + + + 4 + + + 7.1 + + + + + 6 + + + 5 + + + 4.9 + + + + + 7 + + + 6 + + + 3.6 + + + + + 8 + + + 7 + + + 4.0 + + + + + 9 + + + 8 + + + 0.6 + + + + + 10 + + + 9 + + + 1.0 + + + + + 11 + + + 10 + + + 4.3 + + +
+
+ +
+ + + + Group By Columns + + + TRUE + + + + + Polar + + + FALSE + + + + + Inverse + + + FALSE + + + + + Formula + + + {=FOURIER(B6:C40,B1,B2,B3,0)} + + + + + Source Array + + + + + Transformed Array + + + + + Real + + + Imaginary + + + + + Real + + + Imaginary + + + + + 0.392555411592569 + + + 0 + + + + + 17.1775578743134 + + + 3.88635177703826E-015 + + + + + 1.20843701681219 + + + + 0 + + + + + 3.428868795359 + + + 2.37164790000189 + + + + + 0.851477676762644 + + + 0 + + + + + -6.80271615433369 + + + -15.1345439297576 + + + + + 1.78534651907738 + + + 0 + + + + + -1.605447356601 + + + -5.08653060378972 + + + + + 1.77946506138316 + + + 0 + + + + + 0.395847917447356 + + + -2.41926785527625 + + + + + 1.51890060220168 + + + 0 + + + + + -1.49410383304833 + + + -2.39148041275 + + + + + 1.04694666137238 + + + 0 + + + + + 0.87223579298981 + + + -1.14394086206797 + + + + + 0.83110083951399 + + + 0 + + + + + 1.5332458505929 + + + 0.678159168870983 + + + + + 1.23006228455127 + + + 0 + + + + + 0.450563708411459 + + + 0.22911248792634 + + + + + 0.133409796396031 + + + 0 + + + + + 0.545106616940358 + + + 0.411028927740438 + + + + + 0.130471655802496 + + + 0 + + + + + 2.22685996425193 + + + -2.43092236748302 + + + + + 0.386478761838145 + + + 0 + + + + + -1.61522859107175 + + + -2.41682657284899 + + + + + -0.703398287742919 + + + 0 + + + + + 1.30245078290168 + + + 1.45443785733126 + + + + + -0.899115309693977 + + + 0 + + + + + 1.57930628561185 + + + -1.33862736591677 + + + + + -0.124045510064504 + + + 0 + + + + + -1.07572227365276 + + + -0.921557968003809 + + + + + -0.513553513012611 + + + 0 + + + + + -0.0557824179238028 + + + -1.81336029451831 + + + + + -0.613559196487517 + + + 0 + + + + + -0.577666040004067 + + + 1.38887243891951 + + + + + 0.32607259491689 + + + 0 + + + + + -0.826878282157686 + + + -0.186591000796403 + + + + + 0.0316297814625926 + + + 0 + + + + + -0.826878282157715 + + + 0.186591000796416 + + + + + 0.52298725899815 + + + 0 + + + + + -0.577666040004051 + + + -1.38887243891954 + + + + + 0.436798031445888 + + + 0 + + + + + -0.0557824179237846 + + + 1.81336029451832 + + + + + 0.846212627320418 + + + 0 + + + + + -1.07572227365276 + + + 0.921557968003802 + + + + + 0.913061096906024 + + + 0 + + + + + 1.57930628561187 + + + 1.33862736591678 + + + + + 1.2666287534781 + + + 0 + + + + + 1.3024507829017 + + + -1.45443785733125 + + + + + 1.6653650481107 + + + 0 + + + + + -1.61522859107176 + + + 2.416826572849 + + + + + 1.36582636202864 + + + 0 + + + + + 2.22685996425191 + + + 2.43092236748304 + + + + + 1.46722190894756 + + + 0 + + + + + 0.545106616940365 + + + -0.411028927740441 + + + + + 0.66120489728397 + + + 0 + + + + + 0.450563708411458 + + + -0.229112487926344 + + + + + 0.701534531762234 + + + 0 + + + + + 1.53324585059292 + + + -0.678159168870965 + + + + + 0.65869368245062 + + + 0 + + + + + 0.872235792989797 + + + 1.14394086206799 + + + + + 0.287522455580069 + + + 0 + + + + + -1.49410383304834 + + + 2.39148041275001 + + + + + -0.409911360506096 + + + 0 + + + + + 0.395847917447327 + + + 2.41926785527626 + + + + + -0.583168875679498 + + + 0 + + + + + -1.60544735660102 + + + 5.08653060378972 + + + + + -0.799684083650078 + + + 0 + + + + + -6.80271615433379 + + + 15.1345439297575 + + + + + -0.621417306845244 + + + 0 + + + + + 3.42886879535907 + + + -2.37164790000194 + + +
+
+ + + diff --git a/helpcontent2/source/text/scalc/01/statistics.xhp b/helpcontent2/source/text/scalc/01/statistics.xhp new file mode 100644 index 000000000..a81feab1b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics.xhp @@ -0,0 +1,49 @@ + + + + + + +Data Statistics in Calc +/text/scalc/01/statistics.xhp + + + + +
+

Statistics

+Use the data statistics in Calc to perform complex data analysis +
+ +To work on a complex statistical or engineering analysis, you can save steps and time by using Calc Data Statistics. You provide the data and parameters for each analysis, and the set of tools uses the appropriate statistical or engineering functions to calculate and display the results in an output table. + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/01/statistics_anova.xhp b/helpcontent2/source/text/scalc/01/statistics_anova.xhp new file mode 100644 index 000000000..8aed3da8b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_anova.xhp @@ -0,0 +1,271 @@ + + + + + + +ANOVA +/text/scalc/01/statistics_anova.xhp + + + + +Analysis toolpack;analysis of variance +Analysis toolpack;ANOVA +analysis of variance;Analysis toolpack +ANOVA;Analysis toolpack +Data statistics;analysis of variance +Data statistics;ANOVA + + + +
+

Analysis of Variance (ANOVA)

+Produces the analysis of variance (ANOVA) of a given data set +
+
+Choose Data - Statistics - Analysis of Variance (ANOVA) +
+ANOVA is the acronym for ANalysis Of VAriance. This tool produces the analysis of variance of a given data set +For more information on ANOVA, refer to the corresponding Wikipedia article. + + +

Type

+Select if the analysis is for a single factor or for two factor ANOVA. +

Parameters

+Alpha: the level of significance of the test. +Rows per sample: Define how many rows a sample has. + + + +The following table displays the results of the analysis of variance (ANOVA) of the sample data above. + + + +ANOVA - Single Factor + + + + + + + + + + + + + + +Alpha + + +0.05 + + + + + + + + + + + + + + + + + + + + + + + + + + +Groups + + +Count + + +Sum + + +Mean + + +Variance + + + + + + +Column 1 + + +11 + + +461 + + +41.9090909091 + + +139.4909090909 + + + + + + +Column 2 + + +10 + + +597 + + +59.7 + + +287.1222222222 + + + + + + +Column 3 + + +10 + + +447 + + +44.7 + + +227.3444444444 + + + + + + + + + + + + + + + + + + + + +Source of Variation + + +SS + + +df + + +MS + + +F + + +P-value + + +F-critical + + + + +Between Groups + + +1876.5683284457 + + +2 + + +938.2841642229 + + +4.3604117704 + + +0.0224614952 + + +3.340385558 + + + + +Within Groups + + +6025.1090909091 + + +28 + + +215.1824675325 + + + + + + + + +Total + + +7901.6774193548 + + +30 + + + + + + + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_correlation.xhp b/helpcontent2/source/text/scalc/01/statistics_correlation.xhp new file mode 100644 index 000000000..43b1b5d5d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_correlation.xhp @@ -0,0 +1,101 @@ + + + + + + +Data Correlation in Calc +/text/scalc/01/statistics_correlation.xhp + + + + + +Analysis toolpack;correlation +correlation;Analysis toolpack +Data statistics;correlation + + + +
+

Correlation

+Calculates the correlation of two sets of numeric data. +
+
+Choose Data - Statistics - Correlation +
+The correlation coefficient (a value between -1 and +1) means how strongly two variables are related to each other. You can use the CORREL function or the Data Statistics to find the correlation coefficient between two variables. +A correlation coefficient of +1 indicates a perfect positive correlation. +A correlation coefficient of -1 indicates a perfect negative correlation +For more information on statistical correlation, refer to the corresponding Wikipedia article. + + + +The following table displays the results of the correlation of the sample data above. + + + +Correlations + + +Column 1 + + +Column 2 + + +Column 3 + + + + +Column 1 + + +1 + + + + + + + + +Column 2 + + +-0.4029254917 + + +1 + + + + + + +Column 3 + + +-0.2107642836 + + +0.2309714048 + + +1 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_covariance.xhp b/helpcontent2/source/text/scalc/01/statistics_covariance.xhp new file mode 100644 index 000000000..b2b4d1d96 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_covariance.xhp @@ -0,0 +1,97 @@ + + + + + + +Data Covariance in Calc +/text/scalc/01/statistics_covariance.xhp + + + + +Analysis toolpack;covariance +covariance;Analysis toolpack +Data statistics;covariance + + + +
+

Covariance

+Calculates the covariance of two sets of numeric data. +
+
+Choose Data - Statistics - Covariance +
+The covariance is a measure of how much two random variables change together. +For more information on statistical covariance, refer to the corresponding Wikipedia article. + + +The following table displays the results of the covariance of the sample data above. + + + +Covariances + + +Column 1 + + +Column 2 + + +Column 3 + + + + +Column 1 + + +126.8099173554 + + + + + + + + +Column 2 + + +-61.4444444444 + + +258.41 + + + + + + +Column 3 + + +-32 + + +53.11 + + +204.61 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_descriptive.xhp b/helpcontent2/source/text/scalc/01/statistics_descriptive.xhp new file mode 100644 index 000000000..d05d34e16 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_descriptive.xhp @@ -0,0 +1,240 @@ + + + + + + +Descriptive Statistics in Calc +/text/scalc/01/statistics_descriptive.xhp + + + + + +Analysis toolpack;descriptive statistics +descriptive statistics;Analysis toolpack +Data statistics;descriptive statistics + + + +
+

Descriptive Statistics

+Fill a table in the spreadsheet with the main statistical properties of the data set. +
+
+Choose Data - Statistics - Descriptive Statistics +
+The Descriptive Statistics analysis tool generates a report of univariate statistics for data in the input range, providing information about the central tendency and variability of your data. +For more information on descriptive statistics, refer to the corresponding Wikipedia article. + + + +The following table displays the results of the descriptive statistics of the sample data above. + + + + + +Maths + + +Physics + + +Biology + + + + +Mean + + +41.9090909091 + + +59.7 + + +44.7 + + + + +Standard Error + + +3.5610380138 + + +5.3583786934 + + +4.7680650629 + + + + +Mode + + +47 + + +49 + + +60 + + + + +Median + + +40 + + +64.5 + + +43.5 + + + + +Variance + + +139.4909090909 + + +287.1222222222 + + +227.3444444444 + + + + +Standard Deviation + + +11.8106269559 + + +16.944681237 + + +15.0779456308 + + + + +Kurtosis + + +-1.4621677981 + + +-0.9415988746 + + +1.418052719 + + + + +Skewness + + +0.0152409533 + + +-0.2226426904 + + +-0.9766803373 + + + + +Range + + +31 + + +51 + + +50 + + + + +Minimum + + +26 + + +33 + + +12 + + + + +Maximum + + +57 + + +84 + + +62 + + + + +Sum + + +461 + + +597 + + +447 + + + + +Count + + +11 + + +10 + + +10 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_exposmooth.xhp b/helpcontent2/source/text/scalc/01/statistics_exposmooth.xhp new file mode 100644 index 000000000..4ff6a3e1f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_exposmooth.xhp @@ -0,0 +1,177 @@ + + + + + + +Exponential Smoothing in Calc +/text/scalc/01/statistics_exposmooth.xhp + + + + +Analysis toolpack;exponential smoothing +exponential smoothing;Analysis toolpack +Data statistics;exponential smoothing + + + +
+

Exponential Smoothing

+Results in a smoothed data series +
+
+Choose Data - Statistics - Exponential Smoothing +
+Exponential smoothing is a filtering technique that when applied to a data set, produces smoothed results. It is employed in many domains such as stock market, economics and in sampled measurements. +For more information on exponential smoothing, refer to the corresponding Wikipedia article. +

Parameters

+Smoothing Factor: A parameter between 0 and 1 that represents the damping factor Alpha in the smoothing equation. +The resulting smoothing is below with smoothing factor as 0.5: + + + +Alpha + + + + + + +0.5 + + + + + + +Column 1 + + +Column 2 + + + + +1 + + +0 + + + + +1 + + +0 + + + + +0.5 + + +0 + + + + +0.25 + + +0.5 + + + + +0.125 + + +0.25 + + + + +0.0625 + + +0.125 + + + + +0.03125 + + +0.0625 + + + + +0.015625 + + +0.03125 + + + + +0.0078125 + + +0.015625 + + + + +0.00390625 + + +0.0078125 + + + + +0.001953125 + + +0.00390625 + + + + +0.0009765625 + + +0.001953125 + + + + +0.0004882813 + + +0.0009765625 + + + + +0.0002441406 + + +0.0004882813 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_fourier.xhp b/helpcontent2/source/text/scalc/01/statistics_fourier.xhp new file mode 100644 index 000000000..34d0b635d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_fourier.xhp @@ -0,0 +1,652 @@ + + + + + + + Fourier Analysis + /text/scalc/01/statistics_fourier.xhp + + + + + + + +Analysis toolpack;Fourier analysis +Fourier analysis;Analysis toolpack +Data statistics;Fourier analysis + + +
+

Fourier Analysis

+ Produces the Fourier analysis of a data set by computing the Discrete Fourier Transform (DFT) of an input array of complex numbers using a couple of Fast Fourier Transform (FFT) algorithms. +
+
+ Choose Data - Statistics - Fourier Analysis +
+ For more information on Fourier analysis, refer to the corresponding Wikipedia article. + + + Input range has label: Mark when the first row or column of the input array is actually a label and not part of the data analysis. + Input Range is a 2 x N or N x 2 range representing an array of complex number to be transformed, where N is the length of the array. The array represents the real and imaginary parts of the data. + + +

Options:

+ Inverse: When checked, calculates the inverse Discrete Fourier Transform. + Polar: When checked, the results are in polar coordinates (magnitude, phase). + Minimum magnitude for polar form output (in dB): used only when output is in polar form. All frequency components with magnitude less than this value in decibels will be suppressed with a zero magnitude-phase entry. This is very useful when looking at the magnitude-phase spectrum of a signal because there is always some very tiny amount of rounding error when doing FFT algorithms and results in incorrect non-zero phase for non-existent frequencies. By providing a suitable value to this parameter, these non-existent frequency components can be suppressed. + + + + The source data for this example is the same of the FOURIER function page. + + + + Fourier Transform + + + + + Fourier Transform + + + + + Input data range : $B$6:$C$40 + + + + + Input data range : $B$6:$C$40 + + + + + Real + + + Imaginary + + + + + Magnitude + + + Phase + + + + + 17.1775578743134 + + + 3.88635177703826E-15 + + + + + 17.1775578743134 + + + 2.26245884628906E-16 + + + + + 3.428868795359 + + + 2.37164790000189 + + + + + 4.16915518748944 + + + 0.605113892937279 + + + + + -6.80271615433369 + + + -15.1345439297576 + + + + + 16.5931120359682 + + + -1.99322000923881 + + + + + -1.605447356601 + + + -5.08653060378972 + + + + + 5.33387802617444 + + + -1.87652762269615 + + + + + 0.395847917447356 + + + -2.41926785527625 + + + + + 2.45143886917874 + + + -1.40861048708919 + + + + + -1.49410383304833 + + + -2.39148041275 + + + + + 2.81984482347817 + + + -2.12922380028329 + + + + + 0.87223579298981 + + + -1.14394086206797 + + + + + 1.43853952829993 + + + -0.919353665468368 + + + + + 1.5332458505929 + + + 0.678159168870983 + + + + + 1.6765269746366 + + + 0.416434654153369 + + + + + 0.450563708411459 + + + 0.22911248792634 + + + + + 0.505470263676592 + + + 0.470425948779898 + + + + + 0.545106616940358 + + + 0.411028927740438 + + + + + 0.682704916689207 + + + 0.646077879418302 + + + + + 2.22685996425193 + + + -2.43092236748302 + + + + + 3.29670879167654 + + + -0.829181229907427 + + + + + -1.61522859107175 + + + -2.41682657284899 + + + + + 2.90689079338124 + + + -2.15994697868441 + + + + + 1.30245078290168 + + + 1.45443785733126 + + + + + 1.95237484175544 + + + 0.840472341525344 + + + + + 1.57930628561185 + + + -1.33862736591677 + + + + + 2.07029745895472 + + + -0.70310180067089 + + + + + -1.07572227365276 + + + -0.921557968003809 + + + + + 1.41649126309482 + + + -2.43322886402899 + + + + + -0.055782417923803 + + + -1.81336029451831 + + + + + 1.81421807837012 + + + -1.60154853447151 + + + + + -0.577666040004067 + + + 1.38887243891951 + + + + + 1.50421564456836 + + + 1.96495487990047 + + + + + -0.826878282157686 + + + -0.186591000796403 + + + + + 0.847669685126376 + + + -2.91965280961949 + + + + + -0.826878282157715 + + + 0.186591000796416 + + + + + 0.847669685126408 + + + 2.91965280961948 + + + + + -0.577666040004051 + + + -1.38887243891954 + + + + + 1.50421564456838 + + + -1.96495487990045 + + + + + -0.055782417923785 + + + 1.81336029451832 + + + + + 1.81421807837012 + + + 1.6015485344715 + + + + + -1.07572227365276 + + + 0.921557968003802 + + + + + 1.41649126309482 + + + 2.433228864029 + + + + + 1.57930628561187 + + + 1.33862736591678 + + + + + 2.07029745895474 + + + 0.703101800670888 + + + + + 1.3024507829017 + + + -1.45443785733125 + + + + + 1.95237484175543 + + + -0.840472341525331 + + + + + -1.61522859107176 + + + 2.416826572849 + + + + + 2.90689079338125 + + + 2.15994697868441 + + + + + 2.22685996425191 + + + 2.43092236748304 + + + + + 3.29670879167653 + + + 0.829181229907435 + + + + + 0.545106616940365 + + + -0.411028927740441 + + + + + 0.682704916689214 + + + -0.646077879418299 + + + + + 0.450563708411458 + + + -0.229112487926344 + + + + + 0.505470263676594 + + + -0.470425948779905 + + + + + 1.53324585059292 + + + -0.678159168870965 + + + + + 1.6765269746366 + + + -0.416434654153355 + + + + + 0.872235792989797 + + + 1.14394086206799 + + + + + 1.43853952829994 + + + 0.919353665468386 + + + + + -1.49410383304834 + + + 2.39148041275001 + + + + + 2.81984482347818 + + + 2.12922380028329 + + + + + 0.395847917447327 + + + 2.41926785527626 + + + + + 2.45143886917875 + + + 1.4086104870892 + + + + + -1.60544735660102 + + + 5.08653060378972 + + + + + 5.33387802617445 + + + 1.87652762269616 + + + + + -6.80271615433379 + + + 15.1345439297575 + + + + + 16.5931120359682 + + + 1.99322000923882 + + + + + 3.42886879535907 + + + -2.37164790000194 + + + + + 4.16915518748952 + + + -0.605113892937279 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_movingavg.xhp b/helpcontent2/source/text/scalc/01/statistics_movingavg.xhp new file mode 100644 index 000000000..1a9faf27e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_movingavg.xhp @@ -0,0 +1,155 @@ + + + + + + +Moving Average in Calc +/text/scalc/01/statistics_movingavg.xhp + + + + + +Analysis toolpack;moving average +moving average;Analysis toolpack +Data statistics;moving average + + + +
+

Moving Average

+Calculates the moving average of a time series +
+
+Choose Data - Statistics - Moving Average +
+For more information on the moving average, refer to the corresponding Wikipedia article. +

Parameters

+Interval: The number of samples used in the moving average calculation. +

Results of the moving average:

+ + + +Column 1 + + +Column 2 + + + + +#N/A + + +#N/A + + + + +0.3333333333 + + +0.3333333333 + + + + +0 + + +0.3333333333 + + + + +0 + + +0.3333333333 + + + + +0 + + +0 + + + + +0 + + +0 + + + + +0 + + +0 + + + + +0 + + +0 + + + + +0 + + +0 + + + + +0 + + +0 + + + + +0 + + +0 + + + + +0 + + +0 + + + + +#N/A + + +#N/A + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_regression.xhp b/helpcontent2/source/text/scalc/01/statistics_regression.xhp new file mode 100644 index 000000000..165ff3e31 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_regression.xhp @@ -0,0 +1,85 @@ + + + + + + + Regression Analysis + /text/scalc/01/statistics_regression.xhp + + + + +Analysis toolpack;regression analysis +regression analysis;Analysis toolpack +Data statistics;regression analysis +Confidence level;regression analysis +regression analysis;linear +regression analysis;power +regression analysis;logarithmic + + + + +
+

Regression Analysis

+Performs linear, logarithmic, or power regression analysis of a data set comprising one dependent variable and multiple independent variables. +
+For example, a crop yield (dependent variable) may be related to rainfall, temperature conditions, sunshine, humidity, soil quality and more, all of them independent variables. +
+Choose Data - Statistics - Regression +
+For more information on regression analysis, refer to the corresponding Wikipedia article. +

Data

+

Independent variable(s) (X) range:

+Enter a single range that contains multiple independent variable observations (along columns or rows). All X variable observations need to be entered adjacent to each other in the same table. +

Dependent variable (Y) range:

+Enter the range that contains the dependent variable whose regression is to be calculated. +

Both X and Y ranges have labels

+Check to use the first line (or column) of the data sets as variable names in the output range. +

Results to:

+The reference of the top left cell of the range where the results will be displayed. + + +

Output Regression Types

+Set the regression type. Three types are available: + + + + Linear Regression: finds a linear function in the form of y = b + a1.[x1] + a2.[x2] + a3.[x3] ..., where ai is the i-th slope, [xi] is the i-th independent variable, and b is the intercept that best fits the data. + + + Logarithmic regression: finds a logarithmic curve in the form of y = b + a1.ln[x1] + a2.ln[x2] + a3.ln[x3] ..., where ai is the i-th coefficient, b is the intercept and ln[xi] is the natural logarithm of the i-th independent variable, that best fits the data. + + + Power regression: finds a power curve in the form of y = exp( b + a1.ln[x1] + a2.ln[x2] + a3.ln[x3] ...), where ai is the i-th power, [xi] is the i-th independent variable, and b is intercept that best fits the data. + + +

Options

+

Confidence level

+ A numeric value between 0 and 1 (exclusive), default is 0.95. Calc uses this percentage to compute the corresponding confidence intervals for each of the estimates (namely the slopes and intercept). +

Calculate residuals

+ Select whether to opt in or out of computing the residuals, which may be beneficial in cases where you are interested only in the slopes and intercept estimates and their statistics. The residuals give information on how far the actual data points deviate from the predicted data points, based on the regression model. +

Force intercept to be zero

+ Calculates the regression model using zero as the intercept, thus forcing the model to pass through the origin. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_sampling.xhp b/helpcontent2/source/text/scalc/01/statistics_sampling.xhp new file mode 100644 index 000000000..753f70cb7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_sampling.xhp @@ -0,0 +1,242 @@ + + + + + + +Data Sampling in Calc +/text/scalc/01/statistics_sampling.xhp + + + + +Analysis toolpack;sampling +sampling;Analysis toolpack +Data statistics;sampling + + + +
+

Sampling

+Create a table with data sampled from another table. +
+
+Choose Data - Statistics - Sampling +
+Sampling allows you to pick data from a source table (population) to fill a target table. The sampling can be random or in a periodic basis, as well as with or without sample replacement in the source table. +Sampling is done row-wise. That means, the sampled data will pick the whole line of the source table and copy into a line of the target table. +

Sampling Method

+

Random

+Picks exactly Sample Size lines of the source table in a random way. +

Sample size

+Number of lines sampled from the source table. The Sample size is limited to the population size for all sampling methods without replacement. +

With replacement

+When checked, put back samples in population (source table) after draw. A sample can be drawn more than once and therefore a larger sample size than population is possible. This option is mutually exclusive with Keep order. When unchecked, a sample drawn is not put back to the population and sample size is limited to population size. +

Keep order

+When checked, samples are drawn in order of population data. Samples are not put back to the population (exclusive with With replacement). This option is automatically checked for Periodic sampling. When unchecked, samples are drawn in random order. +

Periodic

+Picks lines in a pace defined by Period. +

Period

+The number of lines to skip periodically when sampling. The Period is limited to the population size. + +The following data will be used as example of source data table for sampling: + + + + + +A + + +B + + +C + + + + +1 + + +11 + + +21 + + +31 + + + + +2 + + +12 + + +22 + + +32 + + + + +3 + + +13 + + +23 + + +33 + + + + +4 + + +14 + + +24 + + +34 + + + + +5 + + +15 + + +25 + + +35 + + + + +6 + + +16 + + +26 + + +36 + + + + +7 + + +17 + + +27 + + +37 + + + + +8 + + +18 + + +28 + + +38 + + + + +9 + + +19 + + +29 + + +39 + + +
+ +Sampling with a period of 2 will result in the following table: + + + +12 + + +22 + + +32 + + + + +14 + + +24 + + +34 + + + + +16 + + +26 + + +36 + + + + +18 + + +28 + + +38 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_test_chisqr.xhp b/helpcontent2/source/text/scalc/01/statistics_test_chisqr.xhp new file mode 100644 index 000000000..04052f547 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_chisqr.xhp @@ -0,0 +1,91 @@ + + + + + + +Chi Square Statistics in Calc +/text/scalc/01/statistics_test_chisqr.xhp + + + + +Analysis toolpack;Chi-square test +Chi-square test;Analysis toolpack +Data statistics;Chi-square test + + + +
+

Chi-square test

+Calculates the Chi-square test of a data sample. +
+
+Choose Data - Statistics - Chi-square Test +
+For more information on chi-square tests, refer to the corresponding Wikipedia article. + + + +

Results for Chi-square Test:

+ + + +Test of Independence (Chi-Square) + + + + + + +Alpha + + +0.05 + + + + +df + + +12 + + + + +P-value + + +2.32567054678584E-014 + + + + +Test Statistic + + +91.6870055842 + + + + +Critical Value + + +21.0260698175 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_test_f.xhp b/helpcontent2/source/text/scalc/01/statistics_test_f.xhp new file mode 100644 index 000000000..1fdc54d46 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_f.xhp @@ -0,0 +1,191 @@ + + + + + + +F Test Statistics in Calc +/text/scalc/01/statistics_test_f.xhp + + + + + +Analysis toolpack;F-test +F-test;Analysis toolpack +Data statistics;F-test + + + +
+

F-test

+Calculates the F-Test of two data samples. +
+
+Choose Data - Statistics - F-test +
+A F-test is any statistical test based on the F-distribution under the null hypothesis. +For more information on F-tests, refer to the corresponding Wikipedia article. +

Data

+Variable 1 range: The reference of the range of the first data series to analyze. +Variable 2 range: The reference of the range of the second data series to analyze. +Results to: The reference of the top left cell of the range where the test will be displayed. +

Results for F-Test:

+The following table shows the F-Test for the data series above: + + + +Ftest + + + + + + + + +Alpha + + +0.05 + + + + + + + + +Variable 1 + + +Variable 2 + + + + +Mean + + +16.9230769231 + + +20.4615384615 + + + + +Variance + + +125.0769230769 + + +94.4358974359 + + + + +Observations + + +13 + + +13 + + + + +df + + +12 + + +12 + + + + +F + + +1.3244637524 + + + + + + +P (F<=f) right-tail + + +0.3170614146 + + + + + + +F Critical right-tail + + +2.6866371125 + + + + + + +P (F<=f) left-tail + + +0.6829385854 + + + + + + +F Critical left-tail + + +0.3722125312 + + + + + + +P two-tail + + +0.6341228293 + + + + + + +F Critical two-tail + + +0.3051313549 + + +3.277277094 + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_test_t.xhp b/helpcontent2/source/text/scalc/01/statistics_test_t.xhp new file mode 100644 index 000000000..6a013e6a5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_t.xhp @@ -0,0 +1,211 @@ + + + + + + +T Test Statistics in Calc +/text/scalc/01/statistics_test_t.xhp + + + + + +Analysis toolpack;t-test +Analysis toolpack;paired t-test +t-test;Analysis toolpack +paired t-test;Analysis toolpack +Data statistics;paired t-test + + + +
+

Paired t-test

+Calculates the paired t-Test of two data samples. +
+
+Choose Data - Statistics - Paired t-test +
+A paired t-test is any statistical hypothesis test that follows a Student's t distribution. +For more information on paired t-tests, refer to the corresponding Wikipedia article. +

Data

+Variable 1 range: The reference of the range of the first data series to analyze. +Variable 2 range: The reference of the range of the second data series to analyze. +Results to: The reference of the top left cell of the range where the test will be displayed. +

Results for paired t-test:

+The following table shows the paired t-test for the data series above: + + + +paired t-test + + + + + + + + +Alpha + + +0.05 + + + + + + +Hypothesized Mean Difference + + +0 + + + + + + + + +Variable 1 + + +Variable 2 + + + + +Mean + + +16.9230769231 + + +20.4615384615 + + + + +Variance + + +125.0769230769 + + +94.4358974359 + + + + +Observations + + +13 + + +13 + + + + +Pearson Correlation + + +-0.0617539772 + + + + + + +Observed Mean Difference + + +-3.5384615385 + + + + + + +Variance of the Differences + + +232.9358974359 + + + + + + +df + + +12 + + + + + + +t Stat + + +-0.8359262137 + + + + + + +P (T<=t) one-tail + + +0.2097651442 + + + + + + +t Critical one-tail + + +1.7822875556 + + + + + + +P (T<=t) two-tail + + +0.4195302884 + + + + + + +t Critical two-tail + + +2.1788128297 + + + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/statistics_test_z.xhp b/helpcontent2/source/text/scalc/01/statistics_test_z.xhp new file mode 100644 index 000000000..b54ba44fd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_z.xhp @@ -0,0 +1,188 @@ + + + + + + +Z Test Statistics in Calc +/text/scalc/01/statistics_test_z.xhp + + + + + +Analysis toolpack;Z-test +Z-test;Analysis toolpack +Data statistics;Z-test + + + +
+

Z-test

+Calculates the z-Test of two data samples. +
+
+Choose Data - Statistics - Z-test +
+For more information on Z-tests, refer to the corresponding Wikipedia article. +

Data

+Variable 1 range: The reference of the range of the first data series to analyze. +Variable 2 range: The reference of the range of the second data series to analyze. +Results to: The reference of the top left cell of the range where the test will be displayed. +

Results for z-Test:

+The following table shows the z-Test for the data series above: + + + +z-test + + + + + + + + +Alpha + + +0.05 + + + + + + +Hypothesized Mean Difference + + +0 + + + + + + + + +Variable 1 + + +Variable 2 + + + + +Known Variance + + +0 + + +0 + + + + +Mean + + +16.9230769231 + + +20.4615384615 + + + + +Observations + + +13 + + +13 + + + + +Observed Mean Difference + + +-3.5384615385 + + + + + + +z + + +#DIV/0! + + + + + + +P (Z<=z) one-tail + + +#DIV/0! + + + + + + +z Critical one-tail + + +1.644853627 + + + + + + +P (Z<=z) two-tail + + +#DIV/0! + + + + + + +z Critical two-tail + + +1.9599639845 + + + + +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/01/text2columns.xhp b/helpcontent2/source/text/scalc/01/text2columns.xhp new file mode 100644 index 000000000..dec39b985 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/text2columns.xhp @@ -0,0 +1,64 @@ + + + + + + + + + Text to Columns + /text/scalc/01/text2columns.xhp + + + +text to columns + + + +
+

Text to Columns

+Opens the Text to Columns dialog, where you enter settings to expand the contents of selected cells to multiple cells. +
+
+ +
+

To expand cell contents to multiple cells

+ You can expand cells that contain comma separated values (CSV) into multiple cells in the same row. + For example, cell A1 contains the comma separated values 1,2,3,4, and cell A2 contains the text A,B,C,D. + + + Select the cell or cells that you want to expand. + + + Choose Data - Text to Columns. + You see the Text to Columns dialog. + + + Select the separator options. The preview shows how the current cell contents will be transformed into multiple cells. + + + You can select a fixed width and then click the ruler on the preview to set cell breakup positions. + You can select or enter separator characters to define the positions of breaking points. The separator characters are removed from the resulting cell contents. + In the example, you select the comma as a delimiter character. Cells A1 and A2 will be expanded to four columns each. A1 contains 1, B1 contains 2, and so on. +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/01/xml_source.xhp b/helpcontent2/source/text/scalc/01/xml_source.xhp new file mode 100644 index 000000000..5fe8bfdf9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/xml_source.xhp @@ -0,0 +1,81 @@ + + + + + + + XML Data + /text/scalc/01/xml_source.xhp + + + + + + + + + XML Source;load XML data in spreadsheets + +
+

XML Source

+ Import XML data in a spreadsheet. +
+ The XML Source feature allows to import data from arbitrarily structured XML content into cells in an existing spreadsheet document. It allows XML content to be imported either partially or in full, depending on the structure of the XML content and the map definitions that the user defines. The user can specify multiple non-overlapping sub-structures to be mapped to different cell positions within the same document. The user can import either element contents, attribute values or both. + +
+ Choose Data - XML Source. +
+

XML Source Dialog

+ + + The dialog consists of four parts. + +

Source file

+ This lets you specify the path to the XML file that you wish to import into your document. + +

Map to Document

+ This pane shows the structure of the source XML content as a tree. This is initially empty, and gets populated when you specify the source file. + + Each element in the tree can be one of three types: + + + attribute, represented by the symbol @ + + + single non-recurring element, represented by the symbol </>, and + + + recurring element, represented by the symbol <//>. + + + + A non-recurring element is an element that can only occur once under the same parent. It is mapped to a single cell in the document. + + A recurring element is an element that can appear multiple times under the same parent. It serves as an enclosing parent of a single record entry of multiple record entries. These entries are imported into a range those height equals the number of entries plus one additional header row. + +

Mapped cell

+ This field specifies the position of a cell in the document that an element or an attribute is linked to. If it is a non-recurring element or an attribute, it simply points to the cell where the value of the linked element/attribute will get imported. If it is a recurring element, it points to the top-left cell of the range where the whole record entries plus header will get imported. +

Import

+ Pressing the Import button starts the import process based on the link definitions that the user has provided. Once the import finishes, the dialog will close. +
+ Wiki page on XML Source +
+ + + -- cgit v1.2.3