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/00/00000004.xhp | 33 + helpcontent2/source/text/scalc/00/00000402.xhp | 58 + helpcontent2/source/text/scalc/00/00000403.xhp | 35 + helpcontent2/source/text/scalc/00/00000404.xhp | 161 ++ helpcontent2/source/text/scalc/00/00000405.xhp | 82 + helpcontent2/source/text/scalc/00/00000406.xhp | 82 + helpcontent2/source/text/scalc/00/00000407.xhp | 34 + helpcontent2/source/text/scalc/00/00000412.xhp | 172 ++ .../source/text/scalc/00/avail_release.xhp | 87 + helpcontent2/source/text/scalc/00/sheet_menu.xhp | 46 + 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 + helpcontent2/source/text/scalc/02/02130000.xhp | 51 + helpcontent2/source/text/scalc/02/02140000.xhp | 59 + helpcontent2/source/text/scalc/02/02150000.xhp | 50 + helpcontent2/source/text/scalc/02/02160000.xhp | 49 + helpcontent2/source/text/scalc/02/02170000.xhp | 49 + helpcontent2/source/text/scalc/02/06010000.xhp | 61 + helpcontent2/source/text/scalc/02/06030000.xhp | 86 + helpcontent2/source/text/scalc/02/06040000.xhp | 55 + helpcontent2/source/text/scalc/02/06050000.xhp | 40 + helpcontent2/source/text/scalc/02/06060000.xhp | 57 + helpcontent2/source/text/scalc/02/06070000.xhp | 57 + helpcontent2/source/text/scalc/02/06080000.xhp | 56 + helpcontent2/source/text/scalc/02/08010000.xhp | 39 + helpcontent2/source/text/scalc/02/08080000.xhp | 45 + helpcontent2/source/text/scalc/02/10050000.xhp | 59 + helpcontent2/source/text/scalc/02/10060000.xhp | 58 + helpcontent2/source/text/scalc/02/18010000.xhp | 75 + helpcontent2/source/text/scalc/02/18020000.xhp | 56 + helpcontent2/source/text/scalc/04/01020000.xhp | 859 ++++++++++ helpcontent2/source/text/scalc/05/02140000.xhp | 426 +++++ helpcontent2/source/text/scalc/05/empty_cells.xhp | 320 ++++ .../source/text/scalc/06/calcsamplefiles.xhp | 33 + .../source/text/scalc/guide/address_auto.xhp | 59 + helpcontent2/source/text/scalc/guide/auto_off.xhp | 77 + .../source/text/scalc/guide/autofilter.xhp | 70 + .../source/text/scalc/guide/autoformat.xhp | 82 + .../source/text/scalc/guide/background.xhp | 68 + helpcontent2/source/text/scalc/guide/borders.xhp | 227 +++ helpcontent2/source/text/scalc/guide/calc_date.xhp | 71 + .../source/text/scalc/guide/calc_series.xhp | 83 + .../source/text/scalc/guide/calc_timevalues.xhp | 46 + helpcontent2/source/text/scalc/guide/calculate.xhp | 61 + .../source/text/scalc/guide/cell_enter.xhp | 60 + .../source/text/scalc/guide/cell_protect.xhp | 86 + .../source/text/scalc/guide/cell_unprotect.xhp | 52 + helpcontent2/source/text/scalc/guide/cellcopy.xhp | 79 + .../text/scalc/guide/cellreference_dragdrop.xhp | 67 + .../source/text/scalc/guide/cellreferences.xhp | 87 + .../source/text/scalc/guide/cellreferences_url.xhp | 65 + .../text/scalc/guide/cellstyle_by_formula.xhp | 73 + .../text/scalc/guide/cellstyle_conditional.xhp | 139 ++ .../text/scalc/guide/cellstyle_minusvalue.xhp | 53 + .../text/scalc/guide/change_image_anchor.xhp | 40 + .../source/text/scalc/guide/consolidate.xhp | 89 + helpcontent2/source/text/scalc/guide/csv_files.xhp | 104 ++ .../source/text/scalc/guide/csv_formula.xhp | 86 + .../source/text/scalc/guide/currency_format.xhp | 59 + .../source/text/scalc/guide/database_define.xhp | 65 + .../source/text/scalc/guide/database_filter.xhp | 88 + .../source/text/scalc/guide/database_sort.xhp | 57 + helpcontent2/source/text/scalc/guide/datapilot.xhp | 48 + .../text/scalc/guide/datapilot_createtable.xhp | 82 + .../text/scalc/guide/datapilot_deletetable.xhp | 50 + .../text/scalc/guide/datapilot_edittable.xhp | 56 + .../text/scalc/guide/datapilot_filtertable.xhp | 80 + .../text/scalc/guide/datapilot_formatting.xhp | 64 + .../source/text/scalc/guide/datapilot_grouping.xhp | 61 + .../source/text/scalc/guide/datapilot_tipps.xhp | 50 + .../text/scalc/guide/datapilot_updatetable.xhp | 49 + .../source/text/scalc/guide/dbase_files.xhp | 106 ++ helpcontent2/source/text/scalc/guide/design.xhp | 72 + .../source/text/scalc/guide/edit_multitables.xhp | 51 + helpcontent2/source/text/scalc/guide/filters.xhp | 57 + helpcontent2/source/text/scalc/guide/finding.xhp | 94 ++ .../source/text/scalc/guide/format_table.xhp | 76 + .../source/text/scalc/guide/format_value.xhp | 73 + .../text/scalc/guide/format_value_userdef.xhp | 124 ++ .../source/text/scalc/guide/formula_copy.xhp | 76 + .../source/text/scalc/guide/formula_enter.xhp | 68 + .../source/text/scalc/guide/formula_value.xhp | 55 + helpcontent2/source/text/scalc/guide/formulas.xhp | 106 ++ .../source/text/scalc/guide/fraction_enter.xhp | 53 + helpcontent2/source/text/scalc/guide/goalseek.xhp | 66 + helpcontent2/source/text/scalc/guide/html_doc.xhp | 71 + .../text/scalc/guide/integer_leading_zero.xhp | 88 + helpcontent2/source/text/scalc/guide/keyboard.xhp | 105 ++ helpcontent2/source/text/scalc/guide/line_fix.xhp | 67 + helpcontent2/source/text/scalc/guide/main.xhp | 152 ++ .../source/text/scalc/guide/mark_cells.xhp | 104 ++ .../source/text/scalc/guide/matrixformula.xhp | 69 + .../source/text/scalc/guide/move_dragdrop.xhp | 121 ++ .../source/text/scalc/guide/multi_tables.xhp | 66 + .../source/text/scalc/guide/multioperation.xhp | 124 ++ .../source/text/scalc/guide/multitables.xhp | 73 + .../source/text/scalc/guide/note_insert.xhp | 66 + .../source/text/scalc/guide/numbers_text.xhp | 93 ++ .../source/text/scalc/guide/pivotchart.xhp | 40 + .../source/text/scalc/guide/pivotchart_create.xhp | 58 + .../source/text/scalc/guide/pivotchart_delete.xhp | 36 + .../source/text/scalc/guide/pivotchart_edit.xhp | 41 + .../source/text/scalc/guide/pivotchart_filter.xhp | 44 + .../source/text/scalc/guide/pivotchart_update.xhp | 42 + .../source/text/scalc/guide/print_details.xhp | 93 ++ .../source/text/scalc/guide/print_exact.xhp | 63 + .../source/text/scalc/guide/print_landscape.xhp | 79 + .../source/text/scalc/guide/print_title_row.xhp | 82 + .../source/text/scalc/guide/printranges.xhp | 105 ++ .../text/scalc/guide/relativ_absolut_ref.xhp | 60 + .../source/text/scalc/guide/remove_duplicates.xhp | 68 + .../source/text/scalc/guide/rename_table.xhp | 91 + .../source/text/scalc/guide/rounding_numbers.xhp | 84 + .../source/text/scalc/guide/row_height.xhp | 73 + helpcontent2/source/text/scalc/guide/scenario.xhp | 85 + .../source/text/scalc/guide/sorted_list.xhp | 58 + .../source/text/scalc/guide/specialfilter.xhp | 223 +++ .../source/text/scalc/guide/subtotaltool.xhp | 66 + .../source/text/scalc/guide/super_subscript.xhp | 60 + .../source/text/scalc/guide/table_cellmerge.xhp | 70 + .../source/text/scalc/guide/table_rotate.xhp | 67 + .../source/text/scalc/guide/table_view.xhp | 59 + .../source/text/scalc/guide/text_numbers.xhp | 50 + .../source/text/scalc/guide/text_rotate.xhp | 55 + helpcontent2/source/text/scalc/guide/text_wrap.xhp | 56 + .../text/scalc/guide/userdefined_function.xhp | 120 ++ helpcontent2/source/text/scalc/guide/validity.xhp | 93 ++ .../source/text/scalc/guide/value_with_name.xhp | 92 ++ helpcontent2/source/text/scalc/guide/webquery.xhp | 107 ++ helpcontent2/source/text/scalc/guide/wildcards.xhp | 93 ++ helpcontent2/source/text/scalc/guide/year2000.xhp | 51 + helpcontent2/source/text/scalc/main0000.xhp | 41 + helpcontent2/source/text/scalc/main0100.xhp | 47 + helpcontent2/source/text/scalc/main0101.xhp | 60 + helpcontent2/source/text/scalc/main0102.xhp | 59 + helpcontent2/source/text/scalc/main0103.xhp | 79 + helpcontent2/source/text/scalc/main0104.xhp | 78 + helpcontent2/source/text/scalc/main0105.xhp | 77 + helpcontent2/source/text/scalc/main0106.xhp | 72 + helpcontent2/source/text/scalc/main0107.xhp | 42 + helpcontent2/source/text/scalc/main0112.xhp | 55 + helpcontent2/source/text/scalc/main0116.xhp | 64 + helpcontent2/source/text/scalc/main0200.xhp | 76 + helpcontent2/source/text/scalc/main0202.xhp | 135 ++ helpcontent2/source/text/scalc/main0203.xhp | 69 + helpcontent2/source/text/scalc/main0205.xhp | 87 + helpcontent2/source/text/scalc/main0206.xhp | 51 + helpcontent2/source/text/scalc/main0208.xhp | 44 + helpcontent2/source/text/scalc/main0210.xhp | 60 + helpcontent2/source/text/scalc/main0214.xhp | 57 + helpcontent2/source/text/scalc/main0218.xhp | 70 + helpcontent2/source/text/scalc/main0503.xhp | 51 + 424 files changed, 47739 insertions(+) create mode 100644 helpcontent2/source/text/scalc/00/00000004.xhp create mode 100644 helpcontent2/source/text/scalc/00/00000402.xhp create mode 100644 helpcontent2/source/text/scalc/00/00000403.xhp create mode 100644 helpcontent2/source/text/scalc/00/00000404.xhp create mode 100644 helpcontent2/source/text/scalc/00/00000405.xhp create mode 100644 helpcontent2/source/text/scalc/00/00000406.xhp create mode 100644 helpcontent2/source/text/scalc/00/00000407.xhp create mode 100644 helpcontent2/source/text/scalc/00/00000412.xhp create mode 100644 helpcontent2/source/text/scalc/00/avail_release.xhp create mode 100644 helpcontent2/source/text/scalc/00/sheet_menu.xhp 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 create mode 100644 helpcontent2/source/text/scalc/02/02130000.xhp create mode 100644 helpcontent2/source/text/scalc/02/02140000.xhp create mode 100644 helpcontent2/source/text/scalc/02/02150000.xhp create mode 100644 helpcontent2/source/text/scalc/02/02160000.xhp create mode 100644 helpcontent2/source/text/scalc/02/02170000.xhp create mode 100644 helpcontent2/source/text/scalc/02/06010000.xhp create mode 100644 helpcontent2/source/text/scalc/02/06030000.xhp create mode 100644 helpcontent2/source/text/scalc/02/06040000.xhp create mode 100644 helpcontent2/source/text/scalc/02/06050000.xhp create mode 100644 helpcontent2/source/text/scalc/02/06060000.xhp create mode 100644 helpcontent2/source/text/scalc/02/06070000.xhp create mode 100644 helpcontent2/source/text/scalc/02/06080000.xhp create mode 100644 helpcontent2/source/text/scalc/02/08010000.xhp create mode 100644 helpcontent2/source/text/scalc/02/08080000.xhp create mode 100644 helpcontent2/source/text/scalc/02/10050000.xhp create mode 100644 helpcontent2/source/text/scalc/02/10060000.xhp create mode 100644 helpcontent2/source/text/scalc/02/18010000.xhp create mode 100644 helpcontent2/source/text/scalc/02/18020000.xhp create mode 100644 helpcontent2/source/text/scalc/04/01020000.xhp create mode 100644 helpcontent2/source/text/scalc/05/02140000.xhp create mode 100644 helpcontent2/source/text/scalc/05/empty_cells.xhp create mode 100644 helpcontent2/source/text/scalc/06/calcsamplefiles.xhp create mode 100644 helpcontent2/source/text/scalc/guide/address_auto.xhp create mode 100644 helpcontent2/source/text/scalc/guide/auto_off.xhp create mode 100644 helpcontent2/source/text/scalc/guide/autofilter.xhp create mode 100644 helpcontent2/source/text/scalc/guide/autoformat.xhp create mode 100644 helpcontent2/source/text/scalc/guide/background.xhp create mode 100644 helpcontent2/source/text/scalc/guide/borders.xhp create mode 100644 helpcontent2/source/text/scalc/guide/calc_date.xhp create mode 100644 helpcontent2/source/text/scalc/guide/calc_series.xhp create mode 100644 helpcontent2/source/text/scalc/guide/calc_timevalues.xhp create mode 100644 helpcontent2/source/text/scalc/guide/calculate.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cell_enter.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cell_protect.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cell_unprotect.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cellcopy.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cellreference_dragdrop.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cellreferences.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cellreferences_url.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cellstyle_by_formula.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cellstyle_conditional.xhp create mode 100644 helpcontent2/source/text/scalc/guide/cellstyle_minusvalue.xhp create mode 100644 helpcontent2/source/text/scalc/guide/change_image_anchor.xhp create mode 100644 helpcontent2/source/text/scalc/guide/consolidate.xhp create mode 100644 helpcontent2/source/text/scalc/guide/csv_files.xhp create mode 100644 helpcontent2/source/text/scalc/guide/csv_formula.xhp create mode 100644 helpcontent2/source/text/scalc/guide/currency_format.xhp create mode 100644 helpcontent2/source/text/scalc/guide/database_define.xhp create mode 100644 helpcontent2/source/text/scalc/guide/database_filter.xhp create mode 100644 helpcontent2/source/text/scalc/guide/database_sort.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_createtable.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_deletetable.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_edittable.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_filtertable.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_formatting.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_grouping.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_tipps.xhp create mode 100644 helpcontent2/source/text/scalc/guide/datapilot_updatetable.xhp create mode 100644 helpcontent2/source/text/scalc/guide/dbase_files.xhp create mode 100644 helpcontent2/source/text/scalc/guide/design.xhp create mode 100644 helpcontent2/source/text/scalc/guide/edit_multitables.xhp create mode 100644 helpcontent2/source/text/scalc/guide/filters.xhp create mode 100644 helpcontent2/source/text/scalc/guide/finding.xhp create mode 100644 helpcontent2/source/text/scalc/guide/format_table.xhp create mode 100644 helpcontent2/source/text/scalc/guide/format_value.xhp create mode 100644 helpcontent2/source/text/scalc/guide/format_value_userdef.xhp create mode 100644 helpcontent2/source/text/scalc/guide/formula_copy.xhp create mode 100644 helpcontent2/source/text/scalc/guide/formula_enter.xhp create mode 100644 helpcontent2/source/text/scalc/guide/formula_value.xhp create mode 100644 helpcontent2/source/text/scalc/guide/formulas.xhp create mode 100644 helpcontent2/source/text/scalc/guide/fraction_enter.xhp create mode 100644 helpcontent2/source/text/scalc/guide/goalseek.xhp create mode 100644 helpcontent2/source/text/scalc/guide/html_doc.xhp create mode 100644 helpcontent2/source/text/scalc/guide/integer_leading_zero.xhp create mode 100644 helpcontent2/source/text/scalc/guide/keyboard.xhp create mode 100644 helpcontent2/source/text/scalc/guide/line_fix.xhp create mode 100644 helpcontent2/source/text/scalc/guide/main.xhp create mode 100644 helpcontent2/source/text/scalc/guide/mark_cells.xhp create mode 100644 helpcontent2/source/text/scalc/guide/matrixformula.xhp create mode 100644 helpcontent2/source/text/scalc/guide/move_dragdrop.xhp create mode 100644 helpcontent2/source/text/scalc/guide/multi_tables.xhp create mode 100644 helpcontent2/source/text/scalc/guide/multioperation.xhp create mode 100644 helpcontent2/source/text/scalc/guide/multitables.xhp create mode 100644 helpcontent2/source/text/scalc/guide/note_insert.xhp create mode 100644 helpcontent2/source/text/scalc/guide/numbers_text.xhp create mode 100644 helpcontent2/source/text/scalc/guide/pivotchart.xhp create mode 100644 helpcontent2/source/text/scalc/guide/pivotchart_create.xhp create mode 100644 helpcontent2/source/text/scalc/guide/pivotchart_delete.xhp create mode 100644 helpcontent2/source/text/scalc/guide/pivotchart_edit.xhp create mode 100644 helpcontent2/source/text/scalc/guide/pivotchart_filter.xhp create mode 100644 helpcontent2/source/text/scalc/guide/pivotchart_update.xhp create mode 100644 helpcontent2/source/text/scalc/guide/print_details.xhp create mode 100644 helpcontent2/source/text/scalc/guide/print_exact.xhp create mode 100644 helpcontent2/source/text/scalc/guide/print_landscape.xhp create mode 100644 helpcontent2/source/text/scalc/guide/print_title_row.xhp create mode 100644 helpcontent2/source/text/scalc/guide/printranges.xhp create mode 100644 helpcontent2/source/text/scalc/guide/relativ_absolut_ref.xhp create mode 100644 helpcontent2/source/text/scalc/guide/remove_duplicates.xhp create mode 100644 helpcontent2/source/text/scalc/guide/rename_table.xhp create mode 100644 helpcontent2/source/text/scalc/guide/rounding_numbers.xhp create mode 100644 helpcontent2/source/text/scalc/guide/row_height.xhp create mode 100644 helpcontent2/source/text/scalc/guide/scenario.xhp create mode 100644 helpcontent2/source/text/scalc/guide/sorted_list.xhp create mode 100644 helpcontent2/source/text/scalc/guide/specialfilter.xhp create mode 100644 helpcontent2/source/text/scalc/guide/subtotaltool.xhp create mode 100644 helpcontent2/source/text/scalc/guide/super_subscript.xhp create mode 100644 helpcontent2/source/text/scalc/guide/table_cellmerge.xhp create mode 100644 helpcontent2/source/text/scalc/guide/table_rotate.xhp create mode 100644 helpcontent2/source/text/scalc/guide/table_view.xhp create mode 100644 helpcontent2/source/text/scalc/guide/text_numbers.xhp create mode 100644 helpcontent2/source/text/scalc/guide/text_rotate.xhp create mode 100644 helpcontent2/source/text/scalc/guide/text_wrap.xhp create mode 100644 helpcontent2/source/text/scalc/guide/userdefined_function.xhp create mode 100644 helpcontent2/source/text/scalc/guide/validity.xhp create mode 100644 helpcontent2/source/text/scalc/guide/value_with_name.xhp create mode 100644 helpcontent2/source/text/scalc/guide/webquery.xhp create mode 100644 helpcontent2/source/text/scalc/guide/wildcards.xhp create mode 100644 helpcontent2/source/text/scalc/guide/year2000.xhp create mode 100644 helpcontent2/source/text/scalc/main0000.xhp create mode 100644 helpcontent2/source/text/scalc/main0100.xhp create mode 100644 helpcontent2/source/text/scalc/main0101.xhp create mode 100644 helpcontent2/source/text/scalc/main0102.xhp create mode 100644 helpcontent2/source/text/scalc/main0103.xhp create mode 100644 helpcontent2/source/text/scalc/main0104.xhp create mode 100644 helpcontent2/source/text/scalc/main0105.xhp create mode 100644 helpcontent2/source/text/scalc/main0106.xhp create mode 100644 helpcontent2/source/text/scalc/main0107.xhp create mode 100644 helpcontent2/source/text/scalc/main0112.xhp create mode 100644 helpcontent2/source/text/scalc/main0116.xhp create mode 100644 helpcontent2/source/text/scalc/main0200.xhp create mode 100644 helpcontent2/source/text/scalc/main0202.xhp create mode 100644 helpcontent2/source/text/scalc/main0203.xhp create mode 100644 helpcontent2/source/text/scalc/main0205.xhp create mode 100644 helpcontent2/source/text/scalc/main0206.xhp create mode 100644 helpcontent2/source/text/scalc/main0208.xhp create mode 100644 helpcontent2/source/text/scalc/main0210.xhp create mode 100644 helpcontent2/source/text/scalc/main0214.xhp create mode 100644 helpcontent2/source/text/scalc/main0218.xhp create mode 100644 helpcontent2/source/text/scalc/main0503.xhp (limited to 'helpcontent2/source/text/scalc') diff --git a/helpcontent2/source/text/scalc/00/00000004.xhp b/helpcontent2/source/text/scalc/00/00000004.xhp new file mode 100644 index 000000000..640164de3 --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000004.xhp @@ -0,0 +1,33 @@ + + + + + + + To access this function... + /text/scalc/00/00000004.xhp + + + +To access this function... +More explanations on top of this page. +In the %PRODUCTNAME Calc functions, parameters marked as "optional" can be left out only when no parameter follows. For example, in a function with four parameters, where the last two parameters are marked as "optional", you can leave out parameter 4 or parameters 3 and 4, but you cannot leave out parameter 3 alone.UFI: see #i43239# and #i3879# +Codes greater than 127 may depend on your system's character mapping (for example iso-8859-1, iso-8859-2, Windows-1252, Windows-1250), and hence may not be portable. + + diff --git a/helpcontent2/source/text/scalc/00/00000402.xhp b/helpcontent2/source/text/scalc/00/00000402.xhp new file mode 100644 index 000000000..60b867523 --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000402.xhp @@ -0,0 +1,58 @@ + + + + + + + Edit Menu + /text/scalc/00/00000402.xhp + + + +Edit Menu +Choose Insert - Headers and Footers. +Choose Insert - Headers and Footers - Header and Footer tabs. +Choose Sheet - Fill Cells. +Choose Sheet - Fill Cells - Down. +Choose Sheet - Fill Cells - Right. +Choose Sheet - Fill Cells - Up. +Choose Sheet - Fill Cells - Left. +Choose Sheet - Fill Cells - Sheets. +Choose Sheet - Fill Cells - Series. + +
+Choose Sheet - Clear Cells. +Backspace +
+Choose Sheet - Delete Cells. + +
+Choose Sheet - Delete Sheet. +Open context menu for a sheet tab. +
+ +
+Choose Sheet - Move or Copy Sheet. +Open context menu for a sheet tab. +
+
+ Choose Edit - Cell Protection to activate sheet protection with current cell protection settings. +
+ + diff --git a/helpcontent2/source/text/scalc/00/00000403.xhp b/helpcontent2/source/text/scalc/00/00000403.xhp new file mode 100644 index 000000000..66c4ce3c6 --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000403.xhp @@ -0,0 +1,35 @@ + + + + + + + View Menu + /text/scalc/00/00000403.xhp + + + +View Menu +Choose View - Column & Row Headers. +Choose View - Value Highlighting. +Choose View - Formula Bar or View - Toolbars - Formula Bar. +Choose View - Page Break. +Choose View - Function List. + + diff --git a/helpcontent2/source/text/scalc/00/00000404.xhp b/helpcontent2/source/text/scalc/00/00000404.xhp new file mode 100644 index 000000000..d9873d31c --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000404.xhp @@ -0,0 +1,161 @@ + + + + + + + Insert Menu + /text/scalc/00/00000404.xhp + + + Sun Microsystems, Inc. + + + +

Insert Menu

+
+Choose Sheet - Insert Cells. +Choose View - Toolbars and select the Insert Cells toolbar: +
+ + + + +Icon + + +Insert Cells + + +
+ +
+
+
+ + + + +Icon + + +Insert Cells Down + + +
+ +
+
+ + + + +Icon + + +Insert Cells Right + + +
+ +
+
+ + + + +Icon + + +Insert Rows + + +
+ +
+
+ + + + +Icon + + +Insert Columns + + +
+ +
+Choose Sheet - Insert Sheet. +Choose Sheet - Insert Sheet from File. +
+Choose Insert - Function. +CommandCtrl+F2 + On the Formula bar, click +
+ + + + +Icon + + +Function Wizard + + +
+ +
+
+Insert - Function - Category Database + +Insert - Function - Category Date & Time + +Insert - Function - Category Financial + +Insert - Function - Category Information + +Insert - Function - Category Logical + +Insert - Function - Category Mathematical + +Insert - Function - Category Array + +Insert - Function - Category Statistical + +Insert - Function - Category Text + +Insert - Function - Category Spreadsheet + +Insert - Function - Category Add-In + +Insert - Function - Category Add-In + +Choose Insert - Named Range or Expression. +Choose Sheet - External Links. +
+Choose Sheet - Named Ranges and Expressions - Define. +CommandCtrl+F3 +
+Choose Sheet - Named Ranges and Expressions - Insert. +Choose Sheet - Named Ranges and Expressions - Create. +Choose Sheet - Named Ranges and Expressions - Labels. + + diff --git a/helpcontent2/source/text/scalc/00/00000405.xhp b/helpcontent2/source/text/scalc/00/00000405.xhp new file mode 100644 index 000000000..13ee92fbe --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000405.xhp @@ -0,0 +1,82 @@ + + + + + + + Format Menu + /text/scalc/00/00000405.xhp + + + Sun Microsystems, Inc. + + + +

Format Menu

+
+ Choose Format - Cells. + Press CommandCtrl+1. +
+Choose Format - Cells - Cell Protection tab. +Choose Format - Rows. +Choose Format - Rows - Optimal Height. +
+Choose Format - Rows - Hide. +Choose Format - Columns - Hide. +Choose Sheet - Hide Sheet. +
+
+Choose Format - Rows - Show. +Choose Format - Columns - Show. +
+Choose Format - Columns. +
+Choose Format - Columns - Optimal Width. +Double-click right column separator in column headers. +
+Choose Sheet. +Choose Sheet - Rename Sheet. +Choose Sheet - Show Sheet. +Choose Format - Page. +Choose Format - Page - Sheet tab. +Choose Format - Print Ranges. +Choose Format - Print Ranges - Define. +Choose Format - Print Ranges - Add. +Choose Format - Print Ranges - Clear. +Choose Format - Print Ranges - Edit. +
+Choose Format - AutoFormat Styles. + On the Tools bar, click +
+ + + + +AutoFormat Styles Icon + + +AutoFormat + + +
+
+
+Choose Format - Conditional. + + diff --git a/helpcontent2/source/text/scalc/00/00000406.xhp b/helpcontent2/source/text/scalc/00/00000406.xhp new file mode 100644 index 000000000..64239b361 --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000406.xhp @@ -0,0 +1,82 @@ + + + + + + + Tools Menu + /text/scalc/00/00000406.xhp + + + +

Tools Menu

+Choose Tools - Detective. + +
+Choose Tools - Detective - Trace Precedents. +Shift+F9 +
+Menu Tools - Language - Hyphenation. +Choose Tools - Detective - Remove Precedents. + +
+Choose Tools - Detective - Trace Dependents. +Shift+F5 +
+Choose Tools - Detective - Remove Dependents. +Choose Tools - Detective - Remove All Traces. +Choose Tools - Detective - Trace Error. +Choose Tools - Detective - Fill Mode. +Choose Tools - Detective - Mark Invalid Data. +Choose Tools - Detective - Refresh Traces. +Choose Tools - Detective - AutoRefresh. +Choose Tools - Goal Seek. +Choose Tools - Solver. +Choose Tools - Solver, click Options button. +Choose Tools - Scenarios. + +Choose Tools - Forms. + +Choose Tools - Share Spreadsheet + +Choose Tools - Protect Sheet. +Choose Tools - Protect Spreadsheet Structure. + +
+Choose Data - Calculate - Recalculate. +Press F9 +
+ +
+Choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Formula. +
+ +
+ Choose Data - Calculate - Recalculate hard. + Press Shift+CommandCtrl+F9 +
+ +
+ Select a formula cell or a formula cell range and choose Data - Calculate - Formula to values +
+ +Choose Data - Calculate - AutoCalculate. +Choose Tools - AutoInput. + + diff --git a/helpcontent2/source/text/scalc/00/00000407.xhp b/helpcontent2/source/text/scalc/00/00000407.xhp new file mode 100644 index 000000000..c6ba07932 --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000407.xhp @@ -0,0 +1,34 @@ + + + + + + + Window Menu + /text/scalc/00/00000407.xhp + + + +

Window Menu

+Choose View - Split Window. +Choose View - Freeze Rows and Columns. +Choose View - Freeze Cells - Freeze First Column +Choose View - Freeze Cells - Freeze First Row + + diff --git a/helpcontent2/source/text/scalc/00/00000412.xhp b/helpcontent2/source/text/scalc/00/00000412.xhp new file mode 100644 index 000000000..50de754f2 --- /dev/null +++ b/helpcontent2/source/text/scalc/00/00000412.xhp @@ -0,0 +1,172 @@ + + + + + + + Data Menu + /text/scalc/00/00000412.xhp + + + +

Data Menu

+ Choose Data - Text to Columns. + Choose Data - Define Range. + Choose Data - Select Range. + Choose Data - Sort.... + Choose Data - Sort Ascending + Choose Data - Sort Descending +
+ Choose Data - Sort - Sort Criteria tab. + On Standard bar, click +
+
+ + + + + Icon Sort Ascending + + + + Sort Ascending + + +
+
+
+ + + + + Icon Sort Descending + + + + Sort Descending + + +
+
+
+
+ Choose Data - Sort - Options tab. + Choose Data - More Filters. +
+ Choose Data - AutoFilter. + On Tools bar or Table Data bar, click +
+ + + + + Icon + + + AutoFilter + + +
+
+
+ Choose Data - More Filters - Advanced Filter... . +
+ Choose Data - More Filters - Standard Filter... - Options label. + Choose Data - More Filters - Advanced Filter... - Options label. +
+
+ Choose Data - More Filters - Reset Filter. + On Table Data bar, click Reset Filter/Sort. + + + + + Icon + + + Reset Filter/Sort + + +
+
+ Choose Data - More Filter - Hide AutoFilter. + Choose Data - Subtotals. + Choose Data - Subtotals - 1st, 2nd, 3rd Group tabs. + Choose Data - Subtotals - Options tab. + Choose Data - Validity. + Menu Data - Validity - Criteria tab. + Choose Data - Validity - Input Help tab. + Choose Data - Validity - Error Alert tab. + Choose Data - Multiple Operations. + Choose Data - Consolidate. + Choose Data - Group and Outline. + Choose Data - Group and Outline - Hide Details. + Choose Data - Group and Outline - Show Details. +
+ Choose Data - Group and Outline - Group. + F12 + On Tools bar, click +
+ + + + + Icon + + + Group + + +
+
+
+
+ Choose Data - Group and Outline - Ungroup. + CommandCtrl+F12 + On Tools bar, click +
+ + + + + Icon + + + Ungroup + + +
+
+
+ Choose Data - Group and Outline - AutoOutline. + Choose Data - Group and Outline - Remove Outline. + Choose Data - Group and Outline - Show Details (for some pivot tables). + Choose Data - Pivot Table. + Choose Insert - Pivot Table. + Choose Insert - Pivot Table, in the Select Source dialog choose the option Data source registered in $[officename]. +
+ Choose Insert - Pivot Table, in the Select Source dialog choose the option Current selection. + Choose Insert - Pivot Table, in the Select Source dialog choose the option Data source registered in $[officename], click OK to see Select Data Source dialog. +
+ Choose Data - Pivot Table - Refresh. + Choose Data - Pivot Table - Delete. + Choose Data - Refresh Range. + Choose Data - Group and Outline - Group. + + diff --git a/helpcontent2/source/text/scalc/00/avail_release.xhp b/helpcontent2/source/text/scalc/00/avail_release.xhp new file mode 100644 index 000000000..75383ea1a --- /dev/null +++ b/helpcontent2/source/text/scalc/00/avail_release.xhp @@ -0,0 +1,87 @@ + + + + + + + Available since release + /text/scalc/00/avail_release.xhp + + + + +
+ This function is available since %PRODUCTNAME 3.3. +
+
+ This function is available since %PRODUCTNAME 3.4. +
+
+ This function is available since %PRODUCTNAME 3.5. +
+
+ This function is available since %PRODUCTNAME 3.6. +
+
+ This function is available since %PRODUCTNAME 4.0. +
+
+ This function is available since %PRODUCTNAME 4.1. +
+
+ This function is available since %PRODUCTNAME 4.2. +
+
+ This function is available since %PRODUCTNAME 4.3. +
+
+ This function is available since %PRODUCTNAME 4.4. +
+
+ This function is available since %PRODUCTNAME 5.0. +
+
+ This function is available since %PRODUCTNAME 5.1. +
+
+ This function is available since %PRODUCTNAME 5.2. +
+
+ This function is available since %PRODUCTNAME 5.3. +
+
+ This function is available since %PRODUCTNAME 5.4. +
+
+ This function is available since %PRODUCTNAME 6.0. +
+
+ This function is available since %PRODUCTNAME 6.1. +
+
+ This function is available since %PRODUCTNAME 6.2. +
+
+ This function is available since %PRODUCTNAME 6.3. +
+
+ This function is available since %PRODUCTNAME 6.4. +
+
+ This function is available since %PRODUCTNAME 7.0. +
+
+ This function is available since %PRODUCTNAME 7.1. +
+
+ This function is available since %PRODUCTNAME 7.2. +
+ + diff --git a/helpcontent2/source/text/scalc/00/sheet_menu.xhp b/helpcontent2/source/text/scalc/00/sheet_menu.xhp new file mode 100644 index 000000000..875b1b2c6 --- /dev/null +++ b/helpcontent2/source/text/scalc/00/sheet_menu.xhp @@ -0,0 +1,46 @@ + + + + + + + Sheet Menu + /text/scalc/00/sheet_menu.xhp + + + +

Sheet Menu

+Choose Sheet - Insert Rows - Rows Above. +Choose Sheet - Insert Rows - Rows Below. +Choose Sheet - Insert Columns - Columns Before. +Choose Sheet - Insert Columns - Columns After. +Choose Sheet - Insert Page Break. +Choose Sheet - Insert Page Break - Row Break. +Choose Sheet - Insert Page Break - Column Break. +Choose Sheet - Delete Page Break. +Choose Sheet - Delete Page Break - Row Break. +Choose Sheet - Delete Page Break - Column Break. + +Choose Sheet - Cell Comments - Edit Comment +Choose Sheet - Cell Comments - Hide Comment +Choose Sheet - Cell Comments - Show Comment +Choose Sheet - Cell Comments - Delete Comment +Choose Sheet - Cell Comments - Delete All Comments + + 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 +
+ + + diff --git a/helpcontent2/source/text/scalc/02/02130000.xhp b/helpcontent2/source/text/scalc/02/02130000.xhp new file mode 100644 index 000000000..9c3cd10c7 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/02130000.xhp @@ -0,0 +1,51 @@ + + + + + +Number format: Currency +/text/scalc/02/02130000.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Number format: Currency

+ Applies the default currency format to the selected cells. +
+
+ + + + Currency Number Format Icon + + + Number Format: Currency + + +
+
+
+ Format - Cells - Numbers. +
+ + diff --git a/helpcontent2/source/text/scalc/02/02140000.xhp b/helpcontent2/source/text/scalc/02/02140000.xhp new file mode 100644 index 000000000..20cfb1bde --- /dev/null +++ b/helpcontent2/source/text/scalc/02/02140000.xhp @@ -0,0 +1,59 @@ + + + + + +Number format: Percent +/text/scalc/02/02140000.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Number format: Percent

+Applies the percentage format to the selected cells. +
+
+ + + + +Icon + + +Number Format: Percent + + +
+ +
+percentage calculations + +You can also enter a percentage sign (%) after a number in a cell: +1% corresponds to 0.01 +1 + 16% corresponds to 116% or 1.16 +1%% corresponds to 0.0001 +
+Format - Cells - Numbers +
+ + diff --git a/helpcontent2/source/text/scalc/02/02150000.xhp b/helpcontent2/source/text/scalc/02/02150000.xhp new file mode 100644 index 000000000..ac6bb9fda --- /dev/null +++ b/helpcontent2/source/text/scalc/02/02150000.xhp @@ -0,0 +1,50 @@ + + + + + +Number format: Default +/text/scalc/02/02150000.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Number format: Default

+ Applies the default number format to the selected cells. +
+
+ + + + Icon Standard Format + + + Number Format: Standard + + +
+
+
+ Format - Cells - Numbers. +
+ diff --git a/helpcontent2/source/text/scalc/02/02160000.xhp b/helpcontent2/source/text/scalc/02/02160000.xhp new file mode 100644 index 000000000..05622e11b --- /dev/null +++ b/helpcontent2/source/text/scalc/02/02160000.xhp @@ -0,0 +1,49 @@ + + + + + +Number Format: Add Decimal Place +/text/scalc/02/02160000.xhp + + +Sun Microsystems, Inc. + + + +
mw copied three index entries to Calc guide format_value.xhp + +

Number Format: Add Decimal Place

+Adds one decimal place to the numbers in the selected cells. +
+
+ + + + +Icon Add Decimal Place + + +Number Format: Add Decimal Place + + +
+
+ + diff --git a/helpcontent2/source/text/scalc/02/02170000.xhp b/helpcontent2/source/text/scalc/02/02170000.xhp new file mode 100644 index 000000000..e2e2b59ee --- /dev/null +++ b/helpcontent2/source/text/scalc/02/02170000.xhp @@ -0,0 +1,49 @@ + + + + + +Number Format: Delete Decimal Place +/text/scalc/02/02170000.xhp + + +Sun Microsystems, Inc. + + + +
mw copied three index entries to Calc guide format_value.xhp + +

Number Format: Delete Decimal Place

+Removes one decimal place from the numbers in the selected cells. +
+
+ + + + +Icon Delete Decimal Place + + +Number Format: Delete Decimal Place + + +
+
+ + diff --git a/helpcontent2/source/text/scalc/02/06010000.xhp b/helpcontent2/source/text/scalc/02/06010000.xhp new file mode 100644 index 000000000..9399da39c --- /dev/null +++ b/helpcontent2/source/text/scalc/02/06010000.xhp @@ -0,0 +1,61 @@ + + + + + + + + +Name Box +/text/scalc/02/06010000.xhp + + +Sun Microsystems, Inc. + + + +
+formula bar; sheet area names +sheet area names +showing; cell references +cell references; showing + + + +Name Box +Displays the reference for the current cell, the range of the selected cells, or the name of the area. You can also select a range of cells, and then type a name for that range into the Name Box.UFI: fixes #i28238# +
+
+ + + + +Combo box sheet area + + + +Name Box + + +
+ +
+To jump to a particular cell, or to select a cell range, type the cell reference, or cell range reference in this box, for example, F1, or A1:C4. You can also enter full name of a sheet; the tooltip then changes to "Go To Sheet", and pressing Enter switches to that sheet. + + diff --git a/helpcontent2/source/text/scalc/02/06030000.xhp b/helpcontent2/source/text/scalc/02/06030000.xhp new file mode 100644 index 000000000..cbc1f81b9 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/06030000.xhp @@ -0,0 +1,86 @@ + + + + + + + + + Sum + /text/scalc/02/06030000.xhp + + + +
+functions;sum function icon + formula bar;sum function + sum icon + AutoSum button, see sum icon + +MW inserted a cross-reference +

Select Function

+ Insert a function of a cell range into the current cell. The function can be Sum, Average, Minimum, Maximum and Count. Click in a cell, click this icon, select the function in the drop down list and optionally adjust the cell range. Or select some cells into which the function value will be inserted, then click the icon. The function result is added at the bottom of the range. +
+
+ + + + +Icon Select Function + + + + Select Function + + +
+
+

Select Function applied with no selected range

+$[officename] automatically suggests a cell range, provided that the spreadsheet contains data. If the cell range already contains a function, you can combine it with the new one to yield the function applied to the range data. If the range contains filters, the Subtotal function is inserted instead of the selected function. + Click the Accept icon to use the formula displayed in the input line or Cancel. + + + + +Accept Icon + + + + Accept + + +
+ + + + +Icon Cancel + + + + Cancel + + +
+ +

Select Function applied on a selected range

+When the selected range has two or more rows, the function is calculated for each column. The results are placed in empty cells on the first available row below the range, one result per column. +When the selected range has one row, the function result is placed in the first available cell on the right of the selected range. + + diff --git a/helpcontent2/source/text/scalc/02/06040000.xhp b/helpcontent2/source/text/scalc/02/06040000.xhp new file mode 100644 index 000000000..bc96cf5f1 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/06040000.xhp @@ -0,0 +1,55 @@ + + + + + + + + +Function +/text/scalc/02/06040000.xhp + + + +
+formula bar; functions +functions; formula bar icon + + +Function +Adds a formula to the current cell. Click this icon, and then enter the formula in the Input line. +
+This icon is only available when the Input line box is not active. +
+ + + + +Icon + + + +Function + + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/02/06050000.xhp b/helpcontent2/source/text/scalc/02/06050000.xhp new file mode 100644 index 000000000..a9f181f43 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/06050000.xhp @@ -0,0 +1,40 @@ + + + + + + + + +Input line +/text/scalc/02/06050000.xhp + + +Sun Microsystems, Inc. + + + +
+ +Input line +Enter the formula that you want to add to the current cell. You can also click the Function Wizard icon to insert a predefined function into the formula. +
+ + + diff --git a/helpcontent2/source/text/scalc/02/06060000.xhp b/helpcontent2/source/text/scalc/02/06060000.xhp new file mode 100644 index 000000000..a12414c27 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/06060000.xhp @@ -0,0 +1,57 @@ + + + + + + + + +Cancel +/text/scalc/02/06060000.xhp + + +Sun Microsystems, Inc. + + + +
+formula bar; canceling inputs +functions; canceling input icon + + +Cancel +Clears the contents of the Input line, or cancels the changes that you made to an existing formula. +
+
+ + + + +Icon + + + +Cancel + + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/02/06070000.xhp b/helpcontent2/source/text/scalc/02/06070000.xhp new file mode 100644 index 000000000..fc429343f --- /dev/null +++ b/helpcontent2/source/text/scalc/02/06070000.xhp @@ -0,0 +1,57 @@ + + + + + + + + +Accept +/text/scalc/02/06070000.xhp + + +Sun Microsystems, Inc. + + + +
+formula bar; accepting inputs +functions; accepting input icon + + +Accept +Accepts the contents of the Input line, and then inserts the contents into the current cell. +
+
+ + + + +Icon + + + +Accept + + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/02/06080000.xhp b/helpcontent2/source/text/scalc/02/06080000.xhp new file mode 100644 index 000000000..651d6fdf0 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/06080000.xhp @@ -0,0 +1,56 @@ + + + + + + + + +Theme Selection +/text/scalc/02/06080000.xhp + + +Sun Microsystems, Inc. + + + + +Theme Selection +Applies a formatting style to the selected cells. + The styles include font, border, and background color information. +
+ + + + +Icon + + + +Choose Themes + + +
+ +
+ +Click the formatting theme that you want to apply, and then click OK. + + + diff --git a/helpcontent2/source/text/scalc/02/08010000.xhp b/helpcontent2/source/text/scalc/02/08010000.xhp new file mode 100644 index 000000000..39b648223 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/08010000.xhp @@ -0,0 +1,39 @@ + + + + + + + + +Position in document +/text/scalc/02/08010000.xhp + + +Sun Microsystems, Inc. + + + +
+ +Position in document +Displays the number of the current sheet and the total number of sheets in the spreadsheet. +
+ + diff --git a/helpcontent2/source/text/scalc/02/08080000.xhp b/helpcontent2/source/text/scalc/02/08080000.xhp new file mode 100644 index 000000000..0b73bdfac --- /dev/null +++ b/helpcontent2/source/text/scalc/02/08080000.xhp @@ -0,0 +1,45 @@ + + + + + + + + +Standard Formula, Date/Time, Error Warning +/text/scalc/02/08080000.xhp + + +Sun Microsystems, Inc. + + + +
+formulas;status bar +MW changed index entry + +Standard Formula, Date/Time, Error Warning +Displays information about the current document. By default, the SUM of the contents of the selected cells is displayed. +
+To change the default formula that is displayed, right-click the field, and then choose the formula that you want. The available formulas are: Average, count of values (COUNTA), count of numbers (COUNT), Maximum, Minimum, Sum, or None. +
+Error codes +
+ + diff --git a/helpcontent2/source/text/scalc/02/10050000.xhp b/helpcontent2/source/text/scalc/02/10050000.xhp new file mode 100644 index 000000000..a6b9f0d58 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/10050000.xhp @@ -0,0 +1,59 @@ + + + + + + + + +Zoom In +/text/scalc/02/10050000.xhp + + +Sun Microsystems, Inc. + + + +
+page views; increasing scales +increasing scales in page view +zooming;enlarging page views +mw deleted "scaling;" + +Zoom In +Enlarges the screen display of the current document. The current zoom factor is displayed on the Status Bar. +
+The maximum zoom factor is 400%. +
+ + + + +Icon + + + +Zoom In + + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/02/10060000.xhp b/helpcontent2/source/text/scalc/02/10060000.xhp new file mode 100644 index 000000000..2ed616c7e --- /dev/null +++ b/helpcontent2/source/text/scalc/02/10060000.xhp @@ -0,0 +1,58 @@ + + + + + + + + +Zoom Out +/text/scalc/02/10060000.xhp + + +Sun Microsystems, Inc. + + + +
+page views;reducing scales +zooming;reducing page views +mw deleted "scaling;" + +Zoom Out +Reduces the screen display of the current document. The current zoom factor is displayed on the Status Bar. +
+The minimum zoom factor is 20%. +
+ + + + +Icon + + + +Zooming Out + + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/02/18010000.xhp b/helpcontent2/source/text/scalc/02/18010000.xhp new file mode 100644 index 000000000..f6c5fb777 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/18010000.xhp @@ -0,0 +1,75 @@ + + + + + + + + + + +Insert +/text/scalc/02/18010000.xhp + + + +
+inserting; objects, toolbar icon + + +Insert +Click the arrow next to the icon to open the Insert toolbar, where you can add graphics and special characters to the current sheet. +
+Tools bar icon: +
+ + + + +Icon + + + +Insert + + +
+
+You can select the following icons: +Floating Frame + + +Special Character + + +From File + + + + +Formula + + +Chart + +OLE Object + + + + diff --git a/helpcontent2/source/text/scalc/02/18020000.xhp b/helpcontent2/source/text/scalc/02/18020000.xhp new file mode 100644 index 000000000..c930837f1 --- /dev/null +++ b/helpcontent2/source/text/scalc/02/18020000.xhp @@ -0,0 +1,56 @@ + + + + + + + + +Insert Cells +/text/scalc/02/18020000.xhp + + +Sun Microsystems, Inc. + + + +
+inserting; cells, toolbar icon + + +Insert Cells +Click the arrow next to the icon to open the Insert Cells toolbar, where you can insert cells, rows, and columns into the current sheet. +
+Tools bar icon: + +You can select the following icons: +Insert Cells Down + + +Insert Cells Right + + +Rows + + +Columns + + + + diff --git a/helpcontent2/source/text/scalc/04/01020000.xhp b/helpcontent2/source/text/scalc/04/01020000.xhp new file mode 100644 index 000000000..2c5c6cf12 --- /dev/null +++ b/helpcontent2/source/text/scalc/04/01020000.xhp @@ -0,0 +1,859 @@ + + + + + + Shortcut Keys for Spreadsheets + /text/scalc/04/01020000.xhp + + + +
+ + spreadsheets; shortcut keys in + shortcut keys; spreadsheets + sheet ranges; filling + + mw deleted "matrices;..." +

Shortcut Keys for Spreadsheets

+ +
+ To fill a selected cell range with the formula that you entered on the Input line, press Option +Alt+Enter. + To create a matrix in which all the cells contain the same information as what you entered on the Input line, press Shift+CommandCtrl+Enter. You cannot edit the components of the matrix. + To select multiple cells in different areas of a sheet, hold down CommandCtrl and drag in the different areas. + To select multiple sheets in a spreadsheet, hold down CommandCtrl, and then click the name tabs at the lower edge of the workspace. To select only one sheet in a selection, hold down Shift, and then click the name tab of the sheet. + To insert a manual line break in a cell, click in the cell, and then press CommandCtrl+Enter. + To delete the contents of selected cells, press Backspace. This opens the Delete Contents dialog, where you choose which contents of the cell you want to delete. To delete the contents of selected cells without a dialog, press the Delete key. +

Navigating in Spreadsheets

+ + + + Shortcut Keys + + + + Effect + + + + + + CommandCtrl+Home + + + Moves the cursor to the first cell in the sheet (A1). + + + + + CommandCtrl+End + + + Moves the cursor to the last cell on the sheet that contains data. + + + + + Home + + + Moves the cursor to the first cell of the current row. + + + + + End + + + Moves the cursor to the last cell that contains values in the current row. + + + + + Shift+Home + + + Selects cells from the current cell to the first cell of the current row. + + + + + Shift+End + + + Selects all cells from the current cell to the last cell that contains values in the current row. + + + + + Shift+Page Up + + + Selects cells from the current cell up to one page in the current column or extends the existing selection one page up. + + + + + Shift+Page Down + + + Selects cells from the current cell down to one page in the current column or extends the existing selection one page down. + + + + + Shift+Space + + + Selects the current row or extends the existing selection to all respective rows. + + + + + CommandCtrl+Space + + + Selects the current column or extends the existing selection to all respective columns. + + + + + CommandCtrl+Shift+Space + + + Selects all cells in the sheet. + + + + + CommandCtrl+Left Arrow + + + Moves the cursor leftward to the start and end of cell blocks with data. If the cell to the left of the cursor is empty or the cell with the cursor is empty, the cursor moves leftward in the current row until it reaches the next cell with contents. If all cells in the same row to the left of the cursor are empty, the cursor moves to the first cell in the row. + + + + + CommandCtrl+Right Arrow + + + Moves the cursor rightward to the start and end of cell blocks with data. If the cell to the right of the cursor is empty or the cell with the cursor is empty, the cursor moves rightward in the current row until it reaches the next cell with contents. If all cells in the same row to the right of the cursor are empty, the cursor moves to the last cell in the row. + + + + + CommandCtrl+Up Arrow + + + Moves the cursor upward to the start and end of cell blocks with data. If the cell above the cursor is empty or the cell with the cursor is empty, the cursor moves upward in the current column until it reaches the next cell with contents. If all cells in the same column above the cursor are empty, the cursor moves to the first cell in the column. + + + + + CommandCtrl+Down Arrow + + + Moves the cursor downward to the start and end of cell blocks with data. If the cell below the cursor is empty or the cell with the cursor is empty, the cursor moves downward in the current column until it reaches the next cell with contents. If all cells in the same column below the cursor are empty, the cursor moves to the last cell in the column. + + + + + CommandCtrl+Shift+Arrow + + + Selects all cells of the range created by the cursor movements using the CommandCtrl+Arrows key combinations. If used to select rows and columns together, a rectangular cell range is selected. If the cursor is in an empty cell, the selection will stretch from the current cell up to the first cell with value in the direction of the arrow pressed. + + + + + CommandCtrl+Page Up + + + Moves one sheet to the left. + In the print preview: Moves to the previous print page. + + + + + CommandCtrl+Page Down + + + Moves one sheet to the right. + In the print preview: Moves to the next print page. + + + + + Option +Alt+Page Up + + + Moves one screen to the left. + + + + + Option +Alt+Page Down + + + Moves one screen page to the right. + + + + + Shift+CommandCtrl+Page Up + + + Adds the previous sheet to the current selection of sheets. If all the sheets in a spreadsheet are selected, this shortcut key combination only selects the previous sheet. Makes the previous sheet the current sheet. + + + + + Shift+CommandCtrl+Page Down + + + Adds the next sheet to the current selection of sheets. If all the sheets in a spreadsheet are selected, this shortcut key combination only selects the next sheet. Makes the next sheet the current sheet. + + + + + CommandCtrl+ * + + + where (*) is the multiplication sign on the numeric key pad + Selects the data range that contains the cursor. A range is a contiguous cell range that contains data and is bounded by empty row and columns. + + + + + CommandCtrl+ / + + + where (/) is the division sign on the numeric key pad + Selects the matrix formula range that contains the cursor. + + + + + CommandCtrl+Plus key + + + Insert cells (as in menu Insert - Cells)[sc-features] of 8.June07 + + + + + CommandCtrl+Minus key + + + Delete cells (as in menu Edit - Delete Cells) + + + + + Enter (in a selected range)see i80051 + + + Moves the cursor down one cell in a selected range. To specify the direction that the cursor moves, choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - General and change the option in Press Enter to move selection. + + + + + Enter (after copying cell contents) + + + If cell contents have just been copied to the clipboard and no additional editing has been done in the current file, then pressing Enter will paste clipboard contents to the current cursor position. + + + + + Shift+Enter + + + If the clipboard contains cell contents and no editing has been done in the file, then Shift+Enter has the same behavior as Enter and pastes clipboard contents to the current cursor position. + If no cells are selected, Shift+Enter moves the cursor to the opposite direction defined in the option Press Enter to move selection found in %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - General. + If a range of cells is selected, Shift+Enter moves the cursor inside the current selection to the opposite direction defined in the option Press Enter to move selection. + + + + + CommandCtrl+ ` (see note below this table) + + + Displays or hides the formulas instead of the values in all cells.i56202 + + +
+ The ` key is located next to the "1" key on most English keyboards. If your keyboard does not show this key, you can assign another key: Choose Tools - Customize, click the Keyboard tab. Select the "View" category and the "Toggle Formula" function. + + + spreadsheets; duplicate + spreadsheets; quick rename + +

Copying and Renaming Sheets

+ The sheet tabs used to navigate between sheets can be clicked in combination with keyboard keys to perform the following operations: + + + + Shortcut Keys + + + Effect + + + + + CommandCtrl + Drag sheet tab + + + Creates a copy of the sheet whose tab was clicked. The copied sheet is placed at the position where the mouse button was released. + + + + + OptionAlt + Click sheet tab + + + Makes the sheet name editable. Edit the sheet name and press Enter when finished. + + +
+ +

Function Keys Used in Spreadsheets

+ + + + Shortcut Keys + + + + Effect + + + + + + CommandCtrl+F1 + + + Displays the comment that is attached to the current cell + + + + + F2 + + + With a cell selected, press F2 to open cell contents for editing. If the cell contains a formula, use arrow keys to navigate the sheet to easily enter range addresses into the formula. + Press F2 again to enable the use of arrow keys to move the cursor in the formula text. + Each additional use of the F2 shortcut switches between the two states previously described. + Some dialog boxes have input fields with a Shrink button. Pressing F2 with the cursor inside such field causes the Shrink command to be executed. + + + + + CommandCtrl+F2 + + + Opens the Function Wizard. + + + + + Shift+CommandCtrl+F2 + + + Moves the cursor to the Input line where you can enter a formula for the current cell. + + + + + CommandCtrl+F3 + + + Opens the Define Names dialog. + + + + + Shift+CommandCtrl+F4 + + + Shows or Hides the Database explorer. + + + + + F4 + + + Rearranges the relative or absolute references (for example, A1, $A$1, $A1, A$1) in the input field. + + + + + F5 + + + Shows or hides the Navigator. + + + + + Shift+F5 + + + Traces dependents. + + + + + Shift+F9 + + + Traces precedents. + + + + + Shift+CommandCtrl+F5 + + + Moves the cursor from the Input line to the Sheet area box. You can also use Shift+CommandCtrl+T. + + + + + F7 + + + Checks spelling in the current sheet. + + + + + CommandCtrl+F7 + + + Opens the Thesaurus if the current cell contains text. + + + + + F8 + + + Turns additional selection mode on or off. In this mode, you can use the arrow keys to extend the selection. You can also click in another cell to extend the selection. + + + + + CommandCtrl+F8 + + + Highlights cells containing values. + + + + + F9 + + + Recalculates changed formulas in the current sheet. + + + + + CommandCtrl+Shift+F9 + + + Recalculates all formulas in all sheets. + + + + + CommandCtrl+F9 + + + Updates the selected chart. + + + + + + + Command+T + F11 + + + + + Opens the Styles window where you can apply a formatting style to the contents of the cell or to the current sheet. + + + + + Shift+F11 + + + Creates a document template. + + + + + Shift+Command+Ctrl+F11 + + + Updates the templates. + + + + + F12 + + + Groups the selected data range. + + + + + CommandCtrl+F12 + + + Ungroups the selected data range. + + + + + Option +Alt+Down Arrow + + + Increases the height of current row (only in OpenOffice.org legacy compatibility mode). + + + + + Option +Alt+Up Arrow + + + Decreases the height of current row (only in OpenOffice.org legacy compatibility mode). + + + + + Option +Alt+Right Arrow + + + Increases the width of the current column. + + + + + Option +Alt+Left Arrow + + + Decreases the width of the current column. + + + + + OptionAlt+Shift+Arrow Key + + + Optimizes the column width or row height based on the current cell. + + +
+

Formatting Cells Using Shortcut Keys

+ The following cell formats can be applied with the keyboard: + + + + Shortcut Keys + + + + Effect + + + + + + CommandCtrl+1 (not on the number pad) + + + Open Format Cells dialog + + + + + CommandCtrl+Shift+1 (not on the number pad) + + + Two decimal places, thousands separator + + + + + CommandCtrl+Shift+2 (not on the number pad) + + + Standard exponential format + + + + + CommandCtrl+Shift+3 (not on the number pad) + + + Standard date format + + + + + CommandCtrl+Shift+4 (not on the number pad) + + + Standard currency format + + + + + CommandCtrl+Shift+5 (not on the number pad) + + + Standard percentage format (two decimal places) + + + + + CommandCtrl+Shift+6 (not on the number pad) + + + Standard format + + +
+

Using the pivot table

+ The shortcut keys below are for the Pivot Table Layout dialog. + + + + Keys + + + Effect + + + + + + Tab + + + + Changes the focus by moving forwards through the areas and buttons of the dialog. + + + + + + Shift+Tab + + + + Changes the focus by moving backwards through the areas and buttons of the dialog. + + + + + + Up Arrow + + + + Moves the focus up one item in the current dialog area. + + + + + + Down Arrow + + + + Moves the focus down one item in the current dialog area. + + + + + + Left Arrow + + + + Moves the focus one item to the left in the current dialog area. + + + + + + Right Arrow + + + + Moves the focus one item to the right in the current dialog area. + + + + + + Home + + + + Selects the first item in the current dialog area. + + + + + + End + + + + Selects the last item in the current dialog area. + + + + + OptionAlt and the underlined character in the label "Row Fields" + + + Copies or moves the current field into the "Row Fields" area. + + + + + OptionAlt and the underlined character in the label "Column Fields" + + + Copies or moves the current field into the "Column Fields" area. + + + + + OptionAlt and the underlined character in the label "Data Fields" + + + Copies or moves the current field into the "Data Fields" area. + + + + + OptionAlt and the underlined character in the label "Filters" + + + Copies or moves the current field into the "Filters" area. + + + + + + CommandCtrl+Up Arrow + + + + Moves the current field up one place. + + + + + + CommandCtrl+Down Arrow + + + + Moves the current field down one place. + + + + + + CommandCtrl+Left Arrow + + + + Moves the current field one place to the left. + + + + + + CommandCtrl+Right Arrow + + + + Moves the current field one place to the right. + + + + + + CommandCtrl+Home + + + + Moves the current field to the first place. + + + + + + CommandCtrl+End + + + + Moves the current field to the last place. + + + + + + Delete + + + + Removes the current field from the area. + + +
+
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/05/02140000.xhp b/helpcontent2/source/text/scalc/05/02140000.xhp new file mode 100644 index 000000000..4a54582a7 --- /dev/null +++ b/helpcontent2/source/text/scalc/05/02140000.xhp @@ -0,0 +1,426 @@ + + + + + + + + + Error Codes in %PRODUCTNAME Calc + /text/scalc/05/02140000.xhp + + + +error codes;list of +mw deleted "%PRODUCTNAME Calc;error codes" +Error Codes in %PRODUCTNAME Calc + The following table is an overview of the error messages for %PRODUCTNAME Calc. If the error occurs in the cell that contains the cursor, the error message is displayed on the Status Bar. +### error message +invalid references; error messages + error messages;invalid references + #REF error message + +invalid names; error messages + #NAME error message + + + + + Error Code + + + Message + + + Explanation + + + + + ### + + +none + + + The cell is not wide enough to display the contents. + + + + + #FMT + + + none + + + This value is outside of limits valid for this format + + + + + 501 + + + Invalid character + + + Character in a formula is not valid. + + + + + 502 + + + Invalid argument + + + Function argument is not valid. For example, a negative number for the SQRT() function, for this please use IMSQRT(). + + + + + 503
#NUM! + + + Invalid floating point operation + + + A calculation results in an overflow of the defined value range. + + + + + 504 + + + Parameter list error + + + Function parameter is not valid, for example, text instead of a number, or a domain reference instead of cell reference. + + + + + 507, 508 + + + Error: Pair missing + + + Missing bracket, for example, closing brackets, but no opening brackets + + + + + 509 + + + Missing operator + + + Operator is missing, for example, "=2(3+4) * ", where the operator between "2" and "(" is missing. + + + + + 510 + + + Missing variable + + + Variable is missing, for example when two operators are together "=1+*2". + + + + + 511 + + + Missing variable + + + Function requires more variables than are provided, for example, AND() and OR(). + + + + + 512 + + + Formula overflow + + + + Compiler: the total number of internal tokens, (that is, operators, variables, brackets) in the formula exceeds 8192. + + + + + 513 + + + String overflow + + + + Compiler: an identifier in the formula exceeds 64 kB in size. Interpreter: a result of a string operation exceeds 64 kB in size. + + + + + 514 + + + Internal overflow + + + Sort operation attempted on too much numerical data (max. 100000) or a calculation stack overflow. + + + + + 515 + + + Internal syntax error + + + Unknown error. + + + + + 516 + + + Internal syntax error + + + Matrix is expected on the calculation stack, but is not available. + + + + + 517 + + + Internal syntax error + + + Unknown code, for example, a document with a newer function is loaded in an older version that does not contain the function. + + + + + 518 + + + Internal syntax error + + + Variable is not available + + + + + 519
#VALUE! + + + No value (instead of Err:519 cell displays #VALUE!) + + + The formula yields a value that does not correspond to the definition; or a cell that is referenced in the formula contains text instead of a number.i63264 + + + + + 520 + + + Internal syntax error + + + Compiler creates an unknown compiler code. + + + + + 521
#NULL! + + + Internal syntax error (instead of Err:521 cell displays #NULL!) + + + No code or no result. + + + + + 522 + + + Circular reference + + + Formula refers directly or indirectly to itself and the Iterations option is not set under %PRODUCTNAME - Preferences +Tools - Options - %PRODUCTNAME Calc - Calculate.UFI: fixes #i23854# + + + + + 523 + + + The calculation procedure does not converge + + + Function missed a targeted value, or iterative references do not reach the minimum change within the maximum steps that are set.UFI: see #33769# + + + + + 524
#REF! + + +Not a valid reference (instead of Err:524 cell displays #REF!) + + + + Compiler: a column or row description name could not be resolved. Interpreter: in a formula, the column, row, or sheet that contains a referenced cell is missing. + + + + + 525
#NAME? + + +invalid names (instead of Err:525 cell displays #NAME?) + + + An identifier could not be evaluated, for example, no valid reference, no valid domain name, no column/row label, no macro, incorrect decimal divider, add-in not found. + + + + + 526 + + + Internal syntax error + + + Obsolete, no longer used, but could come from old documents if the result is a formula from a domain. + + + + + 527 + + + Internal overflow + + + + Interpreter: References, such as when a cell references a cell, are too encapsulated. + + + + + 530 + + + No AddIn + + + + Interpreter: AddIn not found. + + + + + 531 + + + No Macro + + + + Interpreter: Macro not found. + + + + + 532
#DIV/0! + + + Division by zero + + + Division operator / if the denominator is 0
Some more functions return this error, for example:
VARP with less than 1 argument
STDEVP with less than 1 argument
VAR with less than 2 arguments
STDEV with less than 2 arguments
STANDARDIZE with stdev=0
NORMDIST with stdev=0 + + + + + 533 + + + Nested arrays are not supported + + + For example, ={1;{2}} + + + + + 538 + + + Error: Array or matrix size + + + - + + + + + 539 + + + Unsupported inline array content + + + For example, ={1+2} + + + + + 540 + + + External content disabled + + + Happens if a function that requires (re)loading of external sources is encountered and the user hasn't confirmed reloading of external sources yet + + +
+ + diff --git a/helpcontent2/source/text/scalc/05/empty_cells.xhp b/helpcontent2/source/text/scalc/05/empty_cells.xhp new file mode 100644 index 000000000..56ccc19b7 --- /dev/null +++ b/helpcontent2/source/text/scalc/05/empty_cells.xhp @@ -0,0 +1,320 @@ + + + + + + + + +Handling of Empty Cells +/text/scalc/05/empty_cells.xhp + + + + + empty cells;handling of +i86303 +Handling of Empty Cells + +In older versions of the software, empty cells were forced to numeric 0 in some contexts and to empty string in others, except in direct comparison where =A1=0 and =A1="" both resulted in TRUE if A1 was empty. Emptiness now is inherited until used, so both =VLOOKUP(...)=0 and =VLOOKUP(...)="" give TRUE if the lookup resulted in an empty cell being returned. +A simple reference to an empty cell is still displayed as numeric 0 but is not necessarily of type numeric anymore, so also comparisons with the referencing cell work as expected. +For the following examples, A1 contains a number, B1 is empty, C1 contains the reference to B1: + + + + Case + + + Formula + + + Results and comments + + + + + A1: 1
B1: <Empty> + + + C1: =B1 + + + Displays 0 + + + + + =B1=0 + + + TRUE + + + + + =B1="" + + + + + + + + =C1=0 + + + + + + + + =C1="" + + + TRUE (previously was FALSE) + + + + + =ISNUMBER(B1) + + + FALSE + + + + + =ISNUMBER(C1) + + + FALSE (previously was TRUE) + + + + + =ISNUMBER(VLOOKUP(1;A1:C1;2)) + + + FALSE (B1) + + + + + =ISNUMBER(VLOOKUP(1;A1:C1;3)) + + + FALSE (C1, previously was TRUE) + + + + + =ISTEXT(B1) + + + + + + + + =ISTEXT(C1) + + + + + + + + =ISTEXT(VLOOKUP(1;A1:C1;2)) + + + FALSE (B1, previously was TRUE) + + + + + =ISTEXT(VLOOKUP(1;A1:C1;3)) + + + FALSE (C1) + + + + + =ISBLANK(B1) + + + + + + + + =ISBLANK(C1) + + + + + + + + =ISBLANK(VLOOKUP(1;A1:C1;2)) + + + TRUE (B1, previously was FALSE) + + + + + =ISBLANK(VLOOKUP(1;A1:C1;3)) + + + FALSE (C1) + + +
+Note that Microsoft Excel behaves different and always returns a number as the result of a reference to an empty cell or a formula cell with the result of an empty cell. For example: + + + + Case + + + Formula + + + Results and comments + + + + + A1: <Empty> + + + B1: =A1 + + + Displays 0, but is just a reference to an empty cell. + + + + + =ISNUMBER(A1) + + + + + + + + =ISTEXT(A1) + + + + + + + + =A1=0 + + + + + + + + =A1="" + + + + + + + + =ISNUMBER(B1) + + + FALSE (Microsoft Excel: TRUE) + + + + + =ISTEXT(B1) + + + + + + + + =B1=0 + + + + + + + + =B1="" + + + TRUE (Microsoft Excel: FALSE) + + + + + C1: =VLOOKUP(...) with empty cell result + + + displays empty (Microsoft Excel: displays 0) + + + + + =ISNUMBER(VLOOKUP(...)) + + + + + + + + =ISTEXT(VLOOKUP(...)) + + + + + + + + =ISNUMBER(C1) + + + FALSE (Microsoft Excel: TRUE) + + + + + =ISTEXT(C1) + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/06/calcsamplefiles.xhp b/helpcontent2/source/text/scalc/06/calcsamplefiles.xhp new file mode 100644 index 000000000..40dc41adc --- /dev/null +++ b/helpcontent2/source/text/scalc/06/calcsamplefiles.xhp @@ -0,0 +1,33 @@ + + + + + + Calc Sample Files + /text/scalc/06/calcsamplefiles.xhp + + + +
+ + +
+ + +
+ + +
+ + +
+ + + + diff --git a/helpcontent2/source/text/scalc/guide/address_auto.xhp b/helpcontent2/source/text/scalc/guide/address_auto.xhp new file mode 100644 index 000000000..03a55b5ac --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/address_auto.xhp @@ -0,0 +1,59 @@ + + + + + + + Recognizing Names as Addressing + /text/scalc/guide/address_auto.xhp + + + + + + + automatic addressing in tables + natural language addressing + formulas; using row/column labels + text in cells; as addressing + addressing; automatic + name recognition on/off + row headers;using in formulas + column headers;using in formulas + columns; finding labels automatically + rows; finding labels automatically + recognizing; column and row labels + +mw changes "names;..." entry to "text in cells;..."mw inserted three index entries from text/shared/optionen/01060500.xhp. Changed "finding;..." entry to "recognizing;..." entry. Adding (Calc) is no longer necessary in this file. + +Recognizing Names as Addressing +You can use cells with text to refer to the rows or to the columns that contain the cells.removed table as a workaround for issue 108715 +Example spreadsheet +In the example spreadsheet, you can use the string 'Column One' in a formula to refer to the cell range B3 to B5, or 'Column Two' for the cell range C2 to C5. You can also use 'Row One' for the cell range B3 to D3, or 'Row Two' for the cell range B4 to D4. The result of a formula that uses a cell name, for example, SUM('Column One'), is 600. +This function is active by default. To turn this function off, choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Calculate and clear the Automatically find column and row labels check box. +If you want a name to be automatically recognized by Calc, the name must start with a letter and be composed of alphanumeric characters. If you enter the name in the formula yourself, enclose the name in single quotation marks ('). If a single quotation mark appears in a name, you must enter a backslash in front of the quotation mark, for example, 'Harry\'s Bar'. + +
mw changed reference to deleted Calc guide address_byname.xhp to refer to Calc guide value_with_name.xhpUFI: changed embedvar links to embed links + + + +
+ + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/auto_off.xhp b/helpcontent2/source/text/scalc/guide/auto_off.xhp new file mode 100644 index 000000000..7ac4ebcaa --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/auto_off.xhp @@ -0,0 +1,77 @@ + + + + + + + Deactivating Automatic Changes + /text/scalc/guide/auto_off.xhp + + + + + + + deactivating; automatic changes + tables; deactivating automatic changes in + AutoInput function on/off + text in cells;AutoInput function + cells; AutoInput function of text + input support in spreadsheets + changing; input in cells + AutoCorrect function;cell contents + cell input;AutoInput function + lowercase letters;AutoInput function (in cells) + capital letters;AutoInput function (in cells) + date formats;avoiding conversion to + number completion on/off + text completion on/off + word completion on/off + +mw added one entry + +Deactivating Automatic Changes +By default, $[officename] automatically corrects many common typing errors and applies formatting while you type. You can immediately undo any automatic changes with Command +Ctrl+Z. +The following shows you how to deactivate and reactivate the automatic changes in $[officename] Calc: + +Automatic Text or Number Completion +When making an entry in a cell, $[officename] Calc automatically suggests matching input found in the same column. This function is known as AutoInput. +To turn the AutoInput on and off, set or remove the check mark in front of Tools - AutoInput. + +Automatic Conversion to Date Format +$[officename] Calc automatically converts certain entries to dates. For example, the entry 1.1 may be interpreted as January 1 of the current year, according to the locale settings of your operating system, and then displayed according to the date format applied to the cell.for sure 1.1 will not be interpreted as a date in the USofA !! +To ensure that an entry is interpreted as text, add an apostrophe at the beginning of the entry. The apostrophe is not displayed in the cell. + +Quotation Marks Replaced by Custom Quotes +Choose Tools - AutoCorrect - AutoCorrect Options. Go to the Localized Options tab and unmark Replace. + +Cell Content Always Begins With Uppercase +Choose Tools - AutoCorrect - AutoCorrect Options. Go to the Options tab. Unmark Capitalize first letter of every sentence. + +Replace Word With Another Word +Choose Tools - AutoCorrect - AutoCorrect Options. Go to the Replace tab. Select the word pair and click Delete. + +
+Tools - AutoInput +Tools - AutoCorrect - AutoCorrect Options +
+ + + diff --git a/helpcontent2/source/text/scalc/guide/autofilter.xhp b/helpcontent2/source/text/scalc/guide/autofilter.xhp new file mode 100644 index 000000000..9d7f1b5a0 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/autofilter.xhp @@ -0,0 +1,70 @@ + + + + + + + + Applying AutoFilter + /text/scalc/guide/autofilter.xhp + + + +filters, see also AutoFilter function + AutoFilter function;applying + sheets; filter values + numbers; filter sheets + columns; AutoFilter function + drop-down menus in sheet columns + database ranges; AutoFilter function +mw made "drop-down..." a one level entry and added a "see also" reference +

Applying AutoFilter +

+ The AutoFilter function inserts a combo box on one or more data columns that lets you select the records (rows) to be displayed. +
+ + + Select the columns you want to use AutoFilter on. + + + Choose Data - Filter - AutoFilter. The combo box arrows are visible in the first row of the range selected. + + + Run the filter by clicking the drop-down arrow in the column heading and choosing an item. + Only those rows whose contents meet the filter criteria are displayed. The other rows are filteredUFI: we must distinguish manually hidden cells from filtered cells, because they behave differently. So don't use the word "hidden" when a filter is applied.. You can see if rows have been filtered from the discontinuous row numbers. The column that has been used for the filter is identified by a different color for the arrow button. + + + When you apply an additional AutoFilter on another column of a filtered data range, then the other combo boxes list only the filtered data. + To display all records again, select the all entry in the AutoFilter combo box. If you choose Standard, the Standard Filter dialog appears, allowing you to set up a standard filter. Choose "Top 10" to display the highest 10 values only. + To stop using AutoFilter, reselect all cells selected in step 1 and once again choose Data - Filter - AutoFilter. +
+ To assign different AutoFilters to different sheets, you must first define a database range on each sheet. +
+ The arithmetic functions also take account of the cells that are not visible due to an applied filter. For example, a sum of an entire column will also total the values in the filtered cells. Apply the SUBTOTAL function if only the cells visible after the application of a filter are to be taken into account. +
+
+ + + + + Data - Filter - AutoFilter + SUBTOTAL +
+ + diff --git a/helpcontent2/source/text/scalc/guide/autoformat.xhp b/helpcontent2/source/text/scalc/guide/autoformat.xhp new file mode 100644 index 000000000..59cea0c96 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/autoformat.xhp @@ -0,0 +1,82 @@ + + + + + + + Using AutoFormat for Tables + /text/scalc/guide/autoformat.xhp + + + + + + tables; AutoFormat + AutoFormat cell ranges + formats; automatically formatting spreadsheets + sheets;AutoFormat + +

Applying Automatic Formatting to a Selected Cell Range

+ Use the AutoFormat feature to quickly apply a format to a selected cell range. +

Applying an AutoFormat to a Selected Cell Range

+ + + Select the range of cells to which the AutoFormat style is to be applied. The range must be at least 3 columns and 3 rows in size. + + + Go to Format - AutoFormat Styles to open the AutoFormat dialog. + + + In the Format list choose the AutoFormat style to apply. + + + In the Formatting section choose which properties from the AutoFormat style to apply to the selected cell range. + + + Click OK to apply the AutoFormat style and close the dialog. + + + In case the color of the cell contents does not change, make sure View - Value Highlighting is disabled. + + defining;AutoFormat styles + +

Defining a new AutoFormat style

+ + + In a Calc spreadsheet, format a cell range with at least 4 columns and 4 rows to serve as model to create the new AutoFormat style. + + + Select the cell range formatted in the previous step and go to Format - AutoFormat Styles. + + + Click Add. + + + In the Name box of the Add AutoFormat dialog, enter a name for the new AutoFormat style. + + + Click OK and close the dialog. + + + The new AutoFormat styles created using the steps above can be applied to any %PRODUCTNAME Calc file. Hence they are not limited to the file where the style was created. +
+ Format - AutoFormat Styles +
+ + diff --git a/helpcontent2/source/text/scalc/guide/background.xhp b/helpcontent2/source/text/scalc/guide/background.xhp new file mode 100644 index 000000000..788fa0f6e --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/background.xhp @@ -0,0 +1,68 @@ + + + + + + + + Defining Background Colors or Background Graphics + /text/scalc/guide/background.xhp + + + + +spreadsheets; backgrounds +backgrounds;cell ranges +tables; backgrounds +cells; backgrounds +rows, see also cells +columns, see also cells + +

Defining Background Colors or Background Graphics +

MW created this file from splitting shared/guide/background.xhp + You can define a background color or use a graphic as a background for cell ranges in $[officename] Calc. +

Applying a Background Color to a $[officename] Calc Spreadsheet

+ + + Select the cells. + + + Choose Format - Cells (or Format Cells from the context menu). + + + On the Background tab page, select the background color. + + +

Graphics in the Background of Cells

+ + + Choose Insert - Image - From File. + + + Select the graphic and click Open. + The graphic is inserted anchored to the current cell. You can move and scale the graphic as you want. In your context menu you can use the Arrange - To Background command to place this in the background. To select a graphic that has been placed in the background, use the Navigator. + + +
+ Watermarks + Background tab page + Formatting Spreadsheets +
+ + diff --git a/helpcontent2/source/text/scalc/guide/borders.xhp b/helpcontent2/source/text/scalc/guide/borders.xhp new file mode 100644 index 000000000..885aad22e --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/borders.xhp @@ -0,0 +1,227 @@ + + + + + + + User Defined Borders in Cells + /text/scalc/guide/borders.xhp + + + + + + cells;borders + line arrangements with cells + borders;cells + +User Defined Borders in Cells + + You can apply a variety of different lines to selected cells. + + + Select the cell or a block of cells. + + + Choose Format - Cells. + + + In the dialog, click the Borders tab. + + + Choose the border options you want to apply and click OK. + + + The options in the Line arrangement area can be used to apply multiple border styles. + Selection of cells + Depending on the selection of cells, the area looks different. + + + + Selection + + + Line arrangement area + + + + + One cell + + + +borders with one cell selected + + + + + + Cells in a column + + + +borders with a column selected + + + + + + Cells in a row + + + +borders with a row selected + + + + + + Cells in a block of 2x2 or more + + + +borders with a block selected + + + +
+

Default Settings

+ Click one of the Default icons to set or reset multiple borders. + + + The thin gray lines inside an icon show the borders that will be reset or cleared. + + + The dark lines inside an icon show the lines that will be set using the selected line style and color. + + + The thick gray lines inside an icon show the lines that will not be changed. + + + Examples + Select a block of about 8x8 cells, then choose Format - Cells - Borders. + +default icon row of Borders tab page + + + + Click the left icon to clear all lines. This removes all outer borders, all inner lines, and all diagonal lines. + + + Click the second icon from the left to set an outer border and to remove all other lines. + + + Click the rightmost icon to set an outer border. The inner lines are not changed, except the diagonal lines, which will be removed.is this a bug? + + + Now you can continue to see which lines the other icons will set or remove. + User Defined Settings + In the User defined area, you can click to set or remove individual lines. The preview shows lines in three different states. + Repeatedly click an edge or a corner to switch through the three different states. + + + + Line types + + + Image + + + Meaning + + + + + A black line + + + +solid line for user defined border + + + + A black line sets the corresponding line of the selected cells. The line is shown as a dotted line when you choose the 0.05 pt line style. Double lines are shown when you select a double line style. + + + + + A gray line + + + +gray line for user defined border + + + + A gray line is shown when the corresponding line of the selected cells will not be changed. No line will be set or removed at this position. + + + + + A white line + + + +white line for user defined border + + + + A white line is shown when the corresponding line of the selected cells will be removed. + + +
+ Examples + Select a single cell, then choose Format - Cells - Borders. + Click the lower edge to set a very thin line as a lower border. All other lines will be removed from the cell. + +setting a thin lower border + + Choose a thicker line style and click the lower edge. This sets a thicker line as a lower border. + +setting a thick line as a border + + Click the second Default icon from the left to set all four borders. Then repeatedly click the lower edge until a white line is shown. This removes the lower border. + +removing lower border + + You can combine several line types and styles. The last image shows how to set thick outer borders (the thick black lines), while any diagonal lines inside the cell will not be touched (gray lines). + +advanced example for cell borders + + + adjacent cells;remove border + + + +

Adjacent Cells

+ This option becomes available when formatting a range of cells that already have borders and the new format defined for the range involves removing outer borders. + By default the option Remove border is disabled and the borders at the edges of the selected range are left unchanged. Check this option if the borders at the edge of the selection should be removed. + If the preset No Borders is chosen then the Remove border option is enabled. + + +
+ + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/calc_date.xhp b/helpcontent2/source/text/scalc/guide/calc_date.xhp new file mode 100644 index 000000000..9e866ef00 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/calc_date.xhp @@ -0,0 +1,71 @@ + + + + + + + Calculating With Dates and Times + /text/scalc/guide/calc_date.xhp + + + + + + + dates; in cells + times; in cells + cells;date and time formats + current date and time values + + + +Calculating With Dates and Times +In $[officename] Calc, you can perform calculations with current date and time values. As an example, to find out exactly how old you are in seconds or hours, follow the following steps: + + + + In a spreadsheet, enter your birthday in cell A1. + + + Enter the following formula in cell A3: =NOW()-A1 + + + After pressing the Enter key you will see the result in date format. Since the result should show the difference between two dates as a number of days, you must format cell A3 as a number. + + + Place the cursor in cell A3, right-click to open a context menu and choose Format Cells. + + + The Format Cells dialog appears. On the Numbers tab, the "Number" category will appear already highlighted. The format is set to "General", which causes the result of a calculation containing date entries to be displayed as a date. To display the result as a number, set the number format to "-1,234" and close the dialog with the OK button. + + + The number of days between today's date and the specified date is displayed in cell A3. + + + Experiment with some additional formulas: in A4 enter =A3*24 to calculate the hours, in A5 enter =A4*60 for the minutes, and in A6 enter =A5*60 for seconds. Press the Enter key after each formula. + + +The time since your date of birth will be calculated and displayed in the various units. The values are calculated as of the exact moment when you entered the last formula and pressed the Enter key. This value is not automatically updated, although "Now" continuously changes. In the Data menu, the menu item Calculate - AutoCalculate is normally active; however, automatic calculation does not apply to the function NOW. This ensures that your computer is not solely occupied with updating the sheet. + +
+ +
+ + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/calc_series.xhp b/helpcontent2/source/text/scalc/guide/calc_series.xhp new file mode 100644 index 000000000..3e89fff53 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/calc_series.xhp @@ -0,0 +1,83 @@ + + + + + + + + + Automatically Calculating Series + /text/scalc/guide/calc_series.xhp + + + +series; calculating + calculating; series + linear series + growth series + date series + powers of 2 calculations + cells; filling automatically + automatic cell filling + AutoFill function + filling;cells, automatically +mw made "powers of 2;..." a one level entry and changed "AutoFill" entryMW changed "auto filling cells" +Automatically Filling in Data Based on Adjacent Cells + + You can automatically fill cells with data with the AutoFill command or the Series command. + Using AutoFill + AutoFill automatically generates a data series based on a defined pattern. + + + On a sheet, click in a cell, and type a number. + + + Click in another cell and then click back in the cell where you typed the number. + + + Drag the fill handle in the bottom right corner of the cell across the cells that you want to fill, and release the mouse button. + The cells are filled with ascending numbers. + + + To quickly create a list of consecutive days, enter Monday in a cell, and drag the fill handle. + Hold down Command +Ctrl if you do not want to fill the cells with different values. + If you select two or more adjacent cells that contain different numbers, and drag, the remaining cells are filled with the arithmetic pattern that is recognized in the numbers. The AutoFill function also recognizes customized lists that are defined under %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Sort Lists. + You can double-click the fill handle to automatically fill all empty columns of the current data block. For example, first enter Jan into A1 and drag the fill handle down to A12 to get the twelve months in the first column. Now enter some values into B1 and C1. Select those two cells, and double-click the fill handle. This fills automatically the data block B1:C12. + Using a Defined Series + + + Select the cell range in the sheet that you want to fill. + + + Choose Sheet - Fill Cells - Series. + + + Select the parameters for the series. + If you select a linear series, the increment that you enter is added to each consecutive number in the series to create the next value. + If you select a growth series, the increment that you enter is multiplied by each consecutive number to create the next value. + If you select a date series, the increment that you enter is added to the time unit that you specify. + + +
+ + Sort lists +
+ + diff --git a/helpcontent2/source/text/scalc/guide/calc_timevalues.xhp b/helpcontent2/source/text/scalc/guide/calc_timevalues.xhp new file mode 100644 index 000000000..e79700198 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/calc_timevalues.xhp @@ -0,0 +1,46 @@ + + + + + + + + +Calculating Time Differences +/text/scalc/guide/calc_timevalues.xhp + + +Sun Microsystems, Inc. + + + +calculating;time differences +time differences + +Calculating Time Differences + +If you want to calculate time differences, for example, the time between 23:30 and 01:10 in the same night, use the following formula: +=(B2<A2)+B2-A2 +The later time is B2 and the earlier time is A2. The result of the example is 01:40 or 1 hour and 40 minutes. +In the formula, an entire 24-hour day has a value of 1 and one hour has a value of 1/24. The logical value in parentheses is 0 or 1, corresponding to 0 or 24 hours. The result returned by the formula is automatically issued in time format due to the sequence of the operands. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/calculate.xhp b/helpcontent2/source/text/scalc/guide/calculate.xhp new file mode 100644 index 000000000..1694c4134 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/calculate.xhp @@ -0,0 +1,61 @@ + + + + + +Calculating in Spreadsheets +/text/scalc/guide/calculate.xhp + + + + +spreadsheets; calculating +calculating; spreadsheets +formulas; calculating +mw changed "formulas;..." entry +Calculating in Spreadsheets +The following is an example of a calculation in $[officename] Calc. + + +Click in a cell, and type a number + + +Press Enter. +The cursor moves down to the next cell. + + +Enter another number. + + +Press the Tab key. +The cursor moves to the right into the next cell. + + +Type in a formula, for example, =A3 * A4 / 100. + + + Press Enter. +The result of the formula appears in the cell. If you want, you can edit the formula in the input line of the Formula bar. +When you edit a formula, the new result is calculated automatically. + + +
+
+ + diff --git a/helpcontent2/source/text/scalc/guide/cell_enter.xhp b/helpcontent2/source/text/scalc/guide/cell_enter.xhp new file mode 100644 index 000000000..208653230 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cell_enter.xhp @@ -0,0 +1,60 @@ + + + + + + + + + Entering Values + /text/scalc/guide/cell_enter.xhp + + + +values; inserting in multiple cells + inserting;values + cell ranges;selecting for data entries + areas, see also cell ranges + +

Entering Values +

+ Calc can simplify entering data and values into multiple cells. You can change some settings to conform to your preferences. +

To Enter Values Into a Range of Cells Manually

+ There are two features that assist you when you enter a block of data manually. +

Area Detection for New Rows

+ In the row below a heading row, you can advance from one cell to the next with the Tab key. After you enter the value into the last cell in the current row, press Enter. Calc positions the cursor below the first cell of the current block. + +area detection + + In row 3, press Tab to advance from cell B3 to C3, D3, and E3. Then press Enter to advance to B4. +

Area Selection

+ Select the area where you want to input values. Now you can start to input values from the cursor position in the selected area. Press the Tab key to advance to the next cell or Shift + Tab to move backward. At the edges of the selected area the tab key jumps inside the selected area. You will not leave the selected area. + +area selection + + Select the area from B3 to E7. Now B3 is waiting for your input. Press Tab to advance to the next cell within the selected area. +

To Enter Values to a Range of Cells Automatically

+ See Automatically Filling in Data Based on Adjacent Cells. +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/cell_protect.xhp b/helpcontent2/source/text/scalc/guide/cell_protect.xhp new file mode 100644 index 000000000..6cb10c722 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cell_protect.xhp @@ -0,0 +1,86 @@ + + + + + + + + + Protecting Cells from Changes + /text/scalc/guide/cell_protect.xhp + + + +protecting;cells and sheets + cells; protecting + cell protection; enabling + sheets; protecting + documents; protecting + cells; hiding for printing + changing; sheet protection + hiding;formulas + formulas;hiding + + +

Protecting Cells from Changes +

+ In %PRODUCTNAME Calc you can protect sheets and the document as a whole. You can choose whether the cells are protected against accidental changes, whether the formulas can be viewed from within Calc, whether the cells are visible or whether the cells can be printed. + Protection can be provided by means of a password, but it does not have to be. If you have assigned a password, protection can only be removed once the correct password has been entered. + Note that the cell protection for cells with the Protected attribute is only effective when you protect the whole sheet. In the default condition, every cell has the Protected attribute. Therefore you must remove the attribute selectively for those cells where the user may make changes. You then protect the whole sheet and save the document. + These protection features are just switches to prevent accidental action. The features are not intended to provide any secure protection. For example, by exporting a sheet to another file format, a user may be able to surpass the protection features. There is only one secure protection: the password that you can apply when saving an OpenDocument file. A file that has been saved with a password can be opened only with the same password. + + + Select the cells that you want to specify the cell protection options for. + + + Choose Format - Cells and click the Cell Protection tab. + + + Select the protection options that you want. All options will be applied only after you protect the sheet from the Tools menu - see below. + Uncheck Protected to allow the user to change the currently selected cells. + Select Protected to prevent changes to the contents and the format of a cell. + Select Hide formula to hide and to protect formulas from changes. + Select Hide when printing to hide protected cells in the printed document. The cells are not hidden onscreen. + + + Click OK. + + + Apply the protection options. + To protect the cells from being changed, viewed or printed according to your settings in the Format - Cells dialog, choose Tools - Protect Sheet. + To protect the structure of the document, for example the count, names, and order of the sheets, from being changed, choose Tools - Protect Spreadsheet Structure. + + + (Optional) Enter a password. + If you forget your password, you cannot deactivate the protection. If you only want to protect cells from accidental changes, set the sheet protection, but do not enter a password. + + + Click OK. + + +
+ + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/cell_unprotect.xhp b/helpcontent2/source/text/scalc/guide/cell_unprotect.xhp new file mode 100644 index 000000000..5039c927f --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cell_unprotect.xhp @@ -0,0 +1,52 @@ + + + + + + + + + Unprotecting Cells + /text/scalc/guide/cell_unprotect.xhp + + + +cell protection; unprotecting + protecting; unprotecting cells + unprotecting cells + +Unprotecting Cells + + + + Click the sheet for which you want to cancel the protection. + + + Select Tools - Protect Sheet or Tools - Protect Spreadsheet Structure to remove the check mark indicating the protected status. + + + If you have assigned a password, enter it in this dialog and click OK. + + + The cells can now be edited, the formulas can be viewed, and all cells can be printed until you reactivate the protection for the sheet or document. +
+ +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/cellcopy.xhp b/helpcontent2/source/text/scalc/guide/cellcopy.xhp new file mode 100644 index 000000000..23d1a612d --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cellcopy.xhp @@ -0,0 +1,79 @@ + + + + + + + + + Only Copy Visible Cells + /text/scalc/guide/cellcopy.xhp + + + +cells; copying/deleting/formatting/moving + rows;visible and invisible + copying; visible cells only + formatting;visible cells only + moving;visible cells only + deleting;visible cells only + invisible cells + filters;copying visible cells only + hidden cells +mw changed "cells;" +Only Copy Visible Cells + + Assume you have hidden a few rows in a cell range. Now you want to copy, delete, or format only the remaining visible rows. + $[officename] behavior depends on how the cells were made invisible, by a filter or manually. + + + + Method and Action + + + Result + + + + + Cells were filtered by AutoFilters, standard filters or advanced filters. + Copy, delete, move, or format a selection of currently visible cells. + + + Only the visible cells of the selection are copied, deleted, moved, or formatted. + + + + + Cells were hidden using the Hide command in the context menu of the row or column headers, or through an outline. + Copy, delete, move, or format a selection of currently visible cells. + + + By default, all cells of the selection, including the hidden cells, are copied, deleted, moved, or formatted. Restrict the selection to visible rows choosing Edit - Select - Select Visible Rows Only or to visible columns choosing Edit - Select - Select Visible Columns Only. + + +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/cellreference_dragdrop.xhp b/helpcontent2/source/text/scalc/guide/cellreference_dragdrop.xhp new file mode 100644 index 000000000..6f687d6da --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cellreference_dragdrop.xhp @@ -0,0 +1,67 @@ + + + + + + + + + Referencing Cells by Drag-and-Drop + /text/scalc/guide/cellreference_dragdrop.xhp + + + +drag and drop; referencing cells + cells; referencing by drag and drop + references;inserting by drag and drop + inserting;references, by drag and drop + +Referencing Cells by Drag-and-Drop + + With the help of the Navigator you can reference cells from one sheet to another sheet in the same document or in a different document. The cells can be inserted as a copy, link, or hyperlink. The range to be inserted must be defined with a name in the original file so that it can be inserted in the target file. + + + Open the document that contains the source cells. + + + To set the source range as the range, select the cells and choose Sheet - Named Ranges and Expressions - Define. Save the source document, and do not close it. + + + Open the sheet in which you want to insert something. + + + Open the Navigator. In the lower box of the Navigator select the source file. + + + In the Navigator, the source file object appears under "Range names". + + + Using the Drag Mode icon in Navigator, choose whether you want the reference to be a hyperlink, link, or copy. + + + Click the name under "Range names" in the Navigator, and drag into the cell of the current sheet where you want to insert the reference. + + + This method can also be used to insert a range from another sheet of the same document into the current sheet. Select the active document as source in step 4 above. +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/cellreferences.xhp b/helpcontent2/source/text/scalc/guide/cellreferences.xhp new file mode 100644 index 000000000..bdd676bc6 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cellreferences.xhp @@ -0,0 +1,87 @@ + + + + + + + + + Referencing a Cell in Another Document + /text/scalc/guide/cellreferences.xhp + + + +sheet references + references; to cells in other sheets/documents + cells; operating in another document + documents;references +mw made "sheet references;" a one level entryMW changed "references;" and added "documents;" +

Referencing Other Sheets +

+ In a sheet cell you can show a reference to a cell in another sheet. + In the same way, a reference can also be made to a cell from another document provided that this document has already been saved as a file. +

To Reference a Cell in the Same Document

+ + + Open a new, empty spreadsheet. By default, it has only a single sheet named Sheet1. Add a second sheet clicking on + button to the left of the sheet tab in the bottom (it will be named Sheet2 by default). + + + By way of example, enter the following formula in cell A1 of Sheet1: + + =Sheet2.A1 + + + + Click the Sheet 2 tab at the bottom of the spreadsheet. Set the cursor in cell A1 there and enter text or a number. + + + If you switch back to Sheet1, you will see the same content in cell A1 there. If the contents of Sheet2.A1 change, then the contents of Sheet1.A1 also change. + + + When referencing a sheet with name containing spaces, use single quotes around the name: ='Sheet with spaces in name'.A1 + The example uses Calc formula syntax. It is also possible to use Excel A1 or R1C1 formula syntax; this is configured on Formula options page. +

To Reference a Cell in Another Document

+ + + Choose File - Open, to load an existing spreadsheet document. + + + Choose File - New, to open a new spreadsheet document. Set the cursor in the cell where you want to insert the external data and enter an equals sign to indicate that you want to begin a formula. + + + Now switch to the document you have just loaded. Click the cell with the data that you want to insert in the new document. + + + Switch back to the new spreadsheet. In the input line you will now see how $[officename] Calc has added the reference to the formula for you. + The reference to a cell of another document contains the name of the other document in single inverted commas, then a hash #, then the name of the sheet of the other document, followed by a point and the name of the cell. + + + Confirm the formula by clicking the green check mark. + + + If you drag the box in the lower right corner of the active cell to select a range of cells, $[officename] automatically inserts the corresponding references in the adjacent cells. As a result, the sheet name is preceded with a "$" sign to designate it as an absolute reference. + + + If you examine the name of the other document in this formula, you will notice that it is written as a URL. This means that you can also enter a URL from the Internet. +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/cellreferences_url.xhp b/helpcontent2/source/text/scalc/guide/cellreferences_url.xhp new file mode 100644 index 000000000..de83a313c --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cellreferences_url.xhp @@ -0,0 +1,65 @@ + + + + + + + + +References to Other Sheets and Referencing URLs +/text/scalc/guide/cellreferences_url.xhp + + + +HTML; in sheet cells +references; URL in cells +cells; Internet references +URL; in Calc +mw deleted "sheet references;" +Referencing URLs + +For example, if you found an Internet page containing current stock exchange information in spreadsheet cells, you can load this page in $[officename] Calc by using the following procedure: + + +In a $[officename] Calc document, position the cursor in the cell into which you want to insert the external data. + + +Choose Sheet - External Links. The External Data dialog appears. + + +Enter the URL of the document or Web page in the dialog. The URL must be in the format: http://www.my-bank.com/table.html. The URL for local or local area network files is the path seen in the File - Open dialog. +$[officename] loads the Web page or file in the "background", that is, without displaying it. In the large list box of the External Data dialog, you can see the name of all the sheets or named ranges you can choose from. + + +Select one or more sheets or named ranges. You can also activate the automatic update function every "n" seconds and click OK. +The contents will be inserted as a link in the $[officename] Calc document. + + +Save your spreadsheet. When you open it again later, $[officename] Calc will update the linked cells following an inquiry. + + +Under %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - General you can choose to have the update, when opened, automatically carried out either always, upon request or never. The update can be started manually in the dialog under Edit - Links. + + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/cellstyle_by_formula.xhp b/helpcontent2/source/text/scalc/guide/cellstyle_by_formula.xhp new file mode 100644 index 000000000..f7c19604b --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cellstyle_by_formula.xhp @@ -0,0 +1,73 @@ + + + + + + + Assigning Formats by Formula + /text/scalc/guide/cellstyle_by_formula.xhp + + + + + + + formats; assigning by formulas + cell formats; assigning by formulas + STYLE function example + cell styles;assigning by formulas + formulas;assigning cell formats + +mw deleted "applying;" + +Assigning Formats by Formula +The STYLE() function can be added to an existing formula in a cell. For example, together with the CURRENT function, you can color a cell depending on its value. The formula =...+STYLE(IF(CURRENT()>3; "Red"; "Green")) applies the cell style "Red" to cells if the value is greater than 3, otherwise the cell style "Green" is applied. +If you would like to apply a formula to all cells in a selected area, you can use the Find & Replace dialog. + + + + Select all the desired cells. + + + Select the menu command Edit - Find & Replace. + + + For the Find term, enter: .* + ".*" is a regular expression that designates the contents of the current cell. + + + Enter the following formula in the Replace field: =&+STYLE(IF(CURRENT()>3;"Red";"Green")) + The "&" symbol designates the current contents of the Find field. The line must begin with an equal sign, since it is a formula. It is assumed that the cell styles "Red" and "Green" already exist. + + + Mark the fields Regular expressions and Current selection only. Click Find All. + All cells with contents that were included in the selection are now highlighted. + + + Click Replace all. + + + +
+ + +
+ + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/cellstyle_conditional.xhp b/helpcontent2/source/text/scalc/guide/cellstyle_conditional.xhp new file mode 100644 index 000000000..aa738a32d --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cellstyle_conditional.xhp @@ -0,0 +1,139 @@ + + + + + + + + + Applying Conditional Formatting + /text/scalc/guide/cellstyle_conditional.xhp + + + +conditional formatting; cells + cells; conditional formatting + formatting; conditional formatting + styles;conditional styles + cell formats; conditional + random numbers;examples + cell styles; copying + copying; cell styles + tables; copying cell styles +mw deleted "formats;" +Applying Conditional Formatting + + Using the menu command Format - Conditional - Condition, the dialog allows you to define conditions per cell, which must be met in order for the selected cells to have a particular format. + 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). + With conditional formatting, you can, for example, highlight the totals that exceed the average value of all totals. If the totals change, the formatting changes correspondingly, without having to apply other styles manually. + To Define the Conditions + + + Select the cells to which you want to apply a conditional style. + + + Choose Format - Conditional - Condition. + + + Enter the condition(s) into the dialog box. The dialog is described in detail in $[officename] Help, and an example is provided below: + + + Example of Conditional Formatting: Highlighting Totals Above/Under the Average Value + Step1: Generate Number Values + You want to give certain values in your tables particular emphasis. For example, in a table of turnovers, you can show all the values above the average in green and all those below the average in red. This is possible with conditional formatting. + + + First of all, create a table in which a few different values occur. For your test you can create tables with any random numbers: + In one of the cells enter the formula =RAND(), and you will obtain a random number between 0 and 1. If you want integers of between 0 and 50, enter the formula =INT(RAND()*50). + + + Copy the formula to create a row of random numbers. Click the bottom right corner of the selected cell, and drag to the right until the desired cell range is selected. + + + In the same way as described above, drag down the corner of the rightmost cell in order to create more rows of random numbers. + + + Step 2: Define Cell Styles + The next step is to apply a cell style to all values that represent above-average turnover, and one to those that are below the average. Ensure that the Styles window is visible before proceeding. + + + Click in a blank cell and select the command Format Cells in the context menu. + + + In the Format Cells dialog on the Background tab, click the Color button and then select a background color. Click OK. + + + In the Styles deck of the Sidebar, click the New Style from Selection icon. Enter the name of the new style. For this example, name the style "Above". + + + To define a second style, click again in a blank cell and proceed as described above. Assign a different background color for the cell and assign a name (for this example, "Below"). + + + Step 3: Calculate Average + In our particular example, we are calculating the average of the random values. The result is placed in a cell: + + + Set the cursor in a blank cell, for example, J14, and choose Insert - Function. + + + Select the AVERAGE function. Use the mouse to select all your random numbers. If you cannot see the entire range, because the Function Wizard is obscuring it, you can temporarily shrink the dialog using the Shrink icon. + + + Close the Function Wizard with OK. + + + Step 4: Apply Cell Styles + Now you can apply the conditional formatting to the sheet: + + + Select all cells with the random numbers. + + + Choose the Format - Conditional - Condition command to open the corresponding dialog. + + + Define the condition as follows: If cell value is less than J14, format with cell style "Below", and if cell value is greater than or equal to J14, format with cell style "Above". + + + Step 5: Copy Cell Style + To apply the conditional formatting to other cells later: + + + Click one of the cells that has been assigned conditional formatting. + + + Copy the cell to the clipboard. + + + Select the cells that are to receive this same formatting. + + + Choose Edit - Paste Special - Paste Special. The Paste Special dialog appears. + + + In the Paste area, check only the Formats box. All other boxes must be unchecked. Click OK. Or you can click the Formats only button instead. + + +
+ + + Format - Conditional - Condition +
+ + diff --git a/helpcontent2/source/text/scalc/guide/cellstyle_minusvalue.xhp b/helpcontent2/source/text/scalc/guide/cellstyle_minusvalue.xhp new file mode 100644 index 000000000..6f158ca75 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/cellstyle_minusvalue.xhp @@ -0,0 +1,53 @@ + + + + + + + + + Highlighting Negative Numbers + /text/scalc/guide/cellstyle_minusvalue.xhp + + + +negative numbers + numbers; highlighting negative numbers + highlighting;negative numbers + colors;negative numbers + number formats;colors for negative numbers +MW made "negative numbers;" a one level entryMW changed "numbers formats;" and "colors;" +Highlighting Negative Numbers + + You can format cells with a number format that highlights negative numbers in red. Alternatively, you can define your own number format in which negative numbers are highlighted in other colors. + + + Select the cells and choose Format - Cells. + + + On the Numbers tab, select a number format and mark Negative numbers red check box. Click OK. + + + The cell number format is defined in two parts. The format for positive numbers and zero is defined in front of the semicolon; after the semicolon the formula for negative numbers is defined. You can change the code (RED) under Format code. For example, instead of RED, enter YELLOW. If the new code appears in the list after clicking the Add icon, this is a valid entry. +
+ + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/change_image_anchor.xhp b/helpcontent2/source/text/scalc/guide/change_image_anchor.xhp new file mode 100644 index 000000000..7216360d6 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/change_image_anchor.xhp @@ -0,0 +1,40 @@ + + + + + + + Changing Image Anchor in Calc + /text/scalc/guide/change_image_anchor.xhp + + + + +anchor;image +image anchor;in Calc +image anchor in Calc;changing + +

Changing the Anchor of an Image +

+Images are inserted in a Calc spreadsheet anchored to cells by default and do not resize when the cell is moved. +Images can be anchored in three different ways: + + + To Cell: the image will move along with the cell, when copying, sorting or inserting and deleting cells above and on the left of the cell holding the anchor. + + To Cell (resize with cell): the image will move along with the cell. In addition, the image height and width will be resized if the cell holding the anchor is later resized. The aspect ratio of the image follows the later aspect ratio of the cell holding the anchor. + + To Page: the image position in the page is not affected by cells ordering or cells movements. + + +

To Change the anchor of an image

Select the image and choose Format - Anchor, or, on the context menu of the image choose Anchor + The original size of the image and cell is preserved while pasting the entire row or entire column for both To Cell and To Cell (resize with cell) options. + + diff --git a/helpcontent2/source/text/scalc/guide/consolidate.xhp b/helpcontent2/source/text/scalc/guide/consolidate.xhp new file mode 100644 index 000000000..d33d46485 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/consolidate.xhp @@ -0,0 +1,89 @@ + + + + + + + + + Consolidating Data + /text/scalc/guide/consolidate.xhp + + + +consolidating data + ranges; combining + combining;cell ranges + tables; combining + data; merging cell ranges + merging;data ranges +mw deleted "values;" +Consolidating Data + + During consolidation, the contents of the cells from several sheets will be combined in one place. + To Combine Cell Contents + + + Open the document that contains the cell ranges to be consolidated. + + + Choose Data - Consolidate to open the Consolidate dialog. + + + From the Source data area box select a source cell range to consolidate with other areas. + If the range is not named, click in the field next to the Source data area. A blinking text cursor appears. Type a reference for the first source data range or select the range with the mouse. + + + Click Add to insert the selected range in the Consolidation areas field. + + + Select additional ranges and click Add after each selection. + + + Specify where you want to display the result by selecting a target range from the Copy results to box. + If the target range is not named, click in the field next to Copy results to and enter the reference of the target range. Alternatively, you can select the range using the mouse or position the cursor in the top left cell of the target range. + + + Select a function from the Function box. The function specifies how the values of the consolidation ranges are linked. The "Sum" function is the default setting. + + + Click OK to consolidate the ranges. + + + Additional Settings + Click More in the Consolidate dialog to display additional settings: + + + Select Link to source data to insert the formulas that generate the results in the target range, rather than the actual results. If you link the data, any values modified in the source range are automatically updated in the target range. + The corresponding cell references in the target range are inserted in consecutive rows, which are automatically ordered and then hidden from view. Only the final result, based on the selected function, is displayed. + + + + + Under Consolidate by, select either Row labels or Column labels if the cells of the source data range are not to be consolidated corresponding to the identical position of the cell in the range, but instead according to a matching row label or column label. + To consolidate by row labels or column labels, the label must be contained in the selected source ranges. + The text in the labels must be identical, so that rows or columns can be accurately matched. If the row or column label does not match any that exist in the target range, it will be appended as a new row or column. + + + The data from the consolidation ranges and target range will be saved when you save the document. If you later open a document in which consolidation has been defined, this data will again be available. +
+ Data - Consolidate +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/csv_files.xhp b/helpcontent2/source/text/scalc/guide/csv_files.xhp new file mode 100644 index 000000000..d0cbd01f0 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/csv_files.xhp @@ -0,0 +1,104 @@ + + + + + + + + Importing and Exporting CSV Files +/text/scalc/guide/csv_files.xhp + + + +number series import +data series import +exporting; tables as text +importing; tables as text +delimited values and files +comma separated files and values +text file import and export +csv files;importing and exporting +tables; importing/exporting as text +text documents; importing to spreadsheets +opening;text csv files +saving;as text csv +MW deleted "importing;text data bases" and copied 4 index entries from scalc/guide/csv_formula.xhpmw added "saving;" and "opening;" +

Opening and Saving Text CSV Files +

+Comma Separated Values (CSV) is a text file format that you can use to exchange data from a database or a spreadsheet between applications. Each line in a Text CSV file represents a record in the database, or a row in a spreadsheet. Each field in a database record or cell in a spreadsheet row is usually separated by a comma. However, you can use other characters to delimit a field, such as a tabulator character. +If the field or cell contains a comma, the field or cell must be enclosed by single quotes (') or double quotes ("). +

To Open a Text CSV File in Calc

+ + +Choose File - Open. + + +Locate the CSV file that you want to open. +If the file has a *.csv extension, select the file. +If the CSV file has another extension, select the file, and then select "Text CSV" in the Filter box + + +Click Open. +The Text Import dialog opens. + + +Specify the options to divide the text in the file into columns. +You can preview the layout of the imported data at the bottom of the Text Import dialog. +Right-click a column in the preview to set the format or to hide the column. +Check the text delimiter box that matches the character used as text delimiter in the file. In case of an unlisted delimiter, type the character into the input box. + + +Click OK. + + +

To Save a Sheet as a Text CSV File

+When you export a spreadsheet to CSV format, only the data on the current sheet is saved. All other information, including formulas and formatting, is lost. + + +Open the Calc sheet that you want to save as a Text CSV file. +Only the current sheet can be exported. + + +Choose File - Save as. + + +In the File name box, enter a name for the file. + + +In the Filter box, select "Text CSV". + + +(Optional) Set the field options for the Text CSV file. +Select Edit filter settings. +In the Export of text files dialog, select the options that you want. +Click OK. + + +Click Save. + + +
+ + +%PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View +Export text files +Import text files +
+ + diff --git a/helpcontent2/source/text/scalc/guide/csv_formula.xhp b/helpcontent2/source/text/scalc/guide/csv_formula.xhp new file mode 100644 index 000000000..70edc0b58 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/csv_formula.xhp @@ -0,0 +1,86 @@ + + + + + + + + + Importing and Exporting Text Files + /text/scalc/guide/csv_formula.xhp + + + +csv files;formulas + formulas; importing/exporting as csv files + exporting;formulas as csv files + importing;csv files with formulas +mw deleted "inserting;", copied 4 index entries to scalc/guide/csv_files.xhp, changed "csv files;" and "formulas;" and added 2 index entries +Importing and Exporting CSV Text Files with Formulas + + Comma separated values (CSV) files are text files that contain the cell contents of a single sheet. Commas, semicolons, or other characters can be used as the field delimiters between the cells. Text strings are put in quotation marks, numbers are written without quotation marks. + To Import a CSV File + + + Choose File - Open. + + + In the File type field, select the format "Text CSV". Select the file and click Open. When a file has the .csv extension, the file type is automatically recognized. + + + You will see the Text Import dialog. Click OK. + + + If the csv file contains formulas, but you want to import the results of those formulas, then choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View and clear the Formulas check box. + To Export Formulas and Values as CSV Files + + + Click the sheet to be written as a csv file. + + + If you want to export the formulas as formulas, for example, in the form =SUM(A1:B5), proceed as follows: + Choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View. + Under Display, mark the Formulas check box. Click OK. + If you want to export the calculation results instead of the formulas, do not mark Formulas. + + + Choose File - Save as. You will see the Save as dialog. + + + In the + File type field select the format "Text CSV". + + + Enter a name and click Save. + + + From the Export of text files dialog that appears, select the character set and the field and text delimiters for the data to be exported, and confirm with OK. + + + If necessary, after you have saved, clear the Formulas check box to see the calculated results in the table again. + + +
+ + %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View + Export text files + Import text files +
+ + diff --git a/helpcontent2/source/text/scalc/guide/currency_format.xhp b/helpcontent2/source/text/scalc/guide/currency_format.xhp new file mode 100644 index 000000000..f0b2f0cb9 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/currency_format.xhp @@ -0,0 +1,59 @@ + + + + + + + + +Cells in Currency Format +/text/scalc/guide/currency_format.xhp + + + +currency formats; spreadsheets +cells; currency formats +international currency formats +formats; currency formats in cells +currencies; default currencies +defaults;currency formats +changing;currency formats +mw changed one index entry +Cells in Currency Format + +In %PRODUCTNAME Calc you can give numbers any currency format. When you click the Currency icon +Icon + in the Formatting bar to format a number, the cell is given the default currency format set under %PRODUCTNAME - PreferencesTools - Options - Language Settings - Languages. +Exchanging of %PRODUCTNAME Calc documents can lead to misunderstandings, if your %PRODUCTNAME Calc document is loaded by a user who uses a different default currency format. +In %PRODUCTNAME Calc you can define that a number that you have formatted as "1,234.50 €", still remains in euros in another country and does not become dollars. +You can change the currency format in the Format Cells dialog (choose Format - Cells - Numbers tab) by two country settings. In the Language combo box select the basic setting for decimal and thousands separators. In the Format list box you can select the currency symbol and its position. + + +For example, if the language is set to "Default" and you are using a german locale setting, the currency format will be "1.234,00 €". A point is used before the thousand digits and a comma before the decimal places. If you now select the subordinate currency format "$ English (US)" from the Format list box , you will get the following format: "$ 1.234,00". As you can see, the separators have remained the same. Only the currency symbol has been changed and converted, but the underlying format of the notation remains the same as in the locale setting. + + +If, under Language, you convert the cells to "English (US)", the English-language locale setting is also transferred and the default currency format is now "$ 1,234.00". + + +
+ +Format - Cells - Numbers +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/database_define.xhp b/helpcontent2/source/text/scalc/guide/database_define.xhp new file mode 100644 index 000000000..5c4d8ffcc --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/database_define.xhp @@ -0,0 +1,65 @@ + + + + + + + + + Defining Database Ranges + /text/scalc/guide/database_define.xhp + + + +tables; database ranges + database ranges; defining + ranges; defining database ranges + defining;database ranges + +Defining a Database Range + + You can define a range of cells in a spreadsheet to use as a database. Each row in this database range corresponds to a database record and each cell in a row corresponds to a database field. You can sort, group, search, and perform calculations on the range as you would in a database. + You can only edit and access a database range in the spreadsheet that contains the range. You cannot access the database range in the %PRODUCTNAME Data Sources view. + To define a database range + + + Select the range of cells that you want to define as a database range. + + + Choose Data - Define Range. + + + In the Name box, enter a name for the database range. + + + Click More. + + + Specify the options for the database range. + + + Click OK. + + +
+ + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/database_filter.xhp b/helpcontent2/source/text/scalc/guide/database_filter.xhp new file mode 100644 index 000000000..2da674b8f --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/database_filter.xhp @@ -0,0 +1,88 @@ + + + + + + + + Filtering Cell Ranges + /text/scalc/guide/database_filter.xhp + + + +cell ranges;applying/removing filters + filtering;cell ranges/database ranges + database ranges;applying/removing filters + removing;cell range filters +MW changed "cell ranges," added "removing;" and made one "database ranges;" entry out of two. Same for "filtering;" +Filtering Cell Ranges + + You can use several filters to filter cell ranges in spreadsheets. A standard filter uses the options that you specify to filter the data. An AutoFilter filters data according to a specific value or string. An advanced filter uses filter criteria from specified cells. + To Apply a Standard Filter to a Cell Range + + + Click in a cell range. + + + Choose Data - More Filters - Standard Filter. + + + In the Standard Filter dialog, specify the filter options that you want. + + + Click OK. + The records that match the filter options that you specified are shown. + + + To Apply an AutoFilter to a Cell Range + + + Click in a cell range or a database range. + If you want to apply multiple AutoFilters to the same sheet, you must first define database ranges, then apply the AutoFilters to the database ranges. + + + Choose Data - AutoFilter. + An arrow button is added to the head of each column in the database range. + + + Click the arrow button in the column that contains the value or string that you want to set as the filter criteria. + + + Select the value or string that you want to use as the filter criteria. + The records that match the filter criteria that you selected are shown. + + + To Remove a Filter From a Cell Range + + + Click in a filtered cell range. + + + Choose Data - Filter - Reset Filter. + + +
+ + + + + Wiki page about defining a data range +
+ + diff --git a/helpcontent2/source/text/scalc/guide/database_sort.xhp b/helpcontent2/source/text/scalc/guide/database_sort.xhp new file mode 100644 index 000000000..e10dd45ca --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/database_sort.xhp @@ -0,0 +1,57 @@ + + + + + + + + Sorting Data + /text/scalc/guide/database_sort.xhp + + + +database ranges; sorting + sorting; database ranges + data;sorting in databases + +Sorting Data + + + + Click in a database range. + If you select a range of cells, only these cells will get sorted. If you just click one cell without selecting, then the whole database range will get sorted. + + + Choose Data - Sort. + The range of cells that will get sorted is shown in inverted colors. + + + Select the sort options that you want. + + + Click OK. + + +
+ + + Wiki page about defining a data range +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/datapilot.xhp b/helpcontent2/source/text/scalc/guide/datapilot.xhp new file mode 100644 index 000000000..6391a629e --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot.xhp @@ -0,0 +1,48 @@ + + + + + +Pivot Table +/text/scalc/guide/datapilot.xhp + + + +pivot table function; introduction +DataPilot, see pivot table function + +

Pivot Table +

+The pivot table (formerly known as DataPilot) allows you to combine, compare, and analyze large amounts of data. You can view different summaries of the source data, you can display the details of areas of interest, and you can create reports. +A table that has been created as a pivot table is an interactive table. Data can be arranged, rearranged or summarized according to different points of view. + + +
+ + + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_createtable.xhp b/helpcontent2/source/text/scalc/guide/datapilot_createtable.xhp new file mode 100644 index 000000000..92a25abd2 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_createtable.xhp @@ -0,0 +1,82 @@ + + + + + + + + + Creating Pivot Tables + /text/scalc/guide/datapilot_createtable.xhp + + + +pivot tables + pivot table function; calling up and applying + +

Creating Pivot Tables +

+ + + Position the cursor within a range of cells containing values, row and column headings. + + + Choose Insert - Pivot Table. The Select Source dialog appears. Choose Current selection and confirm with OK. The table headings are shown as buttons in the Pivot Table dialog. Drag these buttons as required and drop them into the layout areas "Filters", "Column Fields", "Row Fields" and "Data Fields". + + + Drag the desired buttons into one of the four areas. + + + Drag a button to the Filters area to create a button and a listbox on top of the generated pivot table. The listbox can be used to filter the pivot table by the contents of the selected item. You can use drag-and-drop within the generated pivot table to use another page field as a filter. + If the button is dropped in the Data Fields area it will be given a caption that also shows the formula that will be used to calculate the data. + + + By double-clicking on one of the fields in the Data Fields area you can call up the Data Field dialog. + + + Use the Data Field dialog to select the calculations to be used for the data. To make a multiple selection, press the CommandCtrl key while clicking the desired calculation. + + + + + The order of the buttons can be changed at any time by moving them to a different position in the area with the mouse. + + + Remove a button by dragging it back to the area of the other buttons at the right of the dialog. + + + To open the Data Field dialog, double-click one of the buttons in the Row Fields or Column Fields area. Use the dialog to select if and to what extent %PRODUCTNAME calculates display subtotals. + + + Exit the Pivot Table dialog by pressing OK. A Filter button will now be inserted, or a page button for every data field that you dropped in the Filters area. The pivot table is inserted further down. + + +
+ + + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_deletetable.xhp b/helpcontent2/source/text/scalc/guide/datapilot_deletetable.xhp new file mode 100644 index 000000000..29e849cb7 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_deletetable.xhp @@ -0,0 +1,50 @@ + + + + + + + + + Deleting Pivot Tables + /text/scalc/guide/datapilot_deletetable.xhp + + + +pivot table function; deleting tables + deleting;pivot tables + +

Deleting Pivot Tables +

+ In order to delete a pivot table, click any cell in the pivot table, then choose Delete in the context menu. + If you delete a pivot table linked to a pivot chart, the pivot chart is also deleted. A dialog box opens to confirm the pivot chart deletion. + + +
+ + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_edittable.xhp b/helpcontent2/source/text/scalc/guide/datapilot_edittable.xhp new file mode 100644 index 000000000..ab0385e56 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_edittable.xhp @@ -0,0 +1,56 @@ + + + + + + + + + Editing Pivot Tables + /text/scalc/guide/datapilot_edittable.xhp + + + +pivot table function; editing tables +editing;pivot tables + +

Editing Pivot Tables +

+ Click one of the buttons in the pivot table and hold the mouse button down. A special symbol will appear next to the mouse pointer. + By dragging the button to a different position in the same row you can alter the order of the columns. If you drag a button to the left edge of the table into the row headings area, you can change a column into a row. + In the Pivot Table dialog, you can drag a button to the Filters area to create a button and a listbox on top of the pivot table. The listbox can be used to filter the pivot table by the contents of the selected item. You can use drag-and-drop within the pivot table to use another page field as a filter. + To remove a button from the table, just drag it out of the pivot table. Release the mouse button when the mouse pointer positioned within the sheet has become a 'not allowed' icon. The button is deleted. + To edit the pivot table, click a cell inside the pivot table and open the context menu. In the context menu you find the command Properties, which displays the Pivot Table Layout dialog for the current pivot table. + In the pivot table, you can use drag-and-drop or cut/paste commands to rearrange the order of data fields. + You can assign custom display names to fields, field members, subtotals (with some restrictions), and grand totals inside pivot tables. A custom display name is assigned to an item by overwriting the original name with another name. + + +
+ + + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_filtertable.xhp b/helpcontent2/source/text/scalc/guide/datapilot_filtertable.xhp new file mode 100644 index 000000000..3b39683ba --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_filtertable.xhp @@ -0,0 +1,80 @@ + + + + + + +Filtering Pivot Tables +/text/scalc/guide/datapilot_filtertable.xhp + + + + +pivot table function; filtering tables +filtering;pivot tables + +

Filtering Pivot Tables

+You can use filters to remove unwanted data from a pivot table. +Click the Filter button in the sheet to call up the dialog for the filter conditions. Alternatively, call up the context menu of the pivot table and select the Filter command. The Filter dialog appears. Here you can filter the pivot table. +You can also click the arrow on a button in the pivot table to show a pop-up window. In this pop-up window, you can edit the visibility settings of the associated field. + + +The pop-up window displays a list of field members associated with that field. A check box is placed to the left of each field member name. When a field has an alternative display name that differs from its original name, that name is displayed in the list. + + +Enable or disable a checkbox to show or hide the associated field member in the pivot table. + + +Enable or disable the All checkbox to show all or none of the field members. + + +Select a field member in the pop-up window and click the Show only the current item button to show only the selected field member. All other field members are hidden in the pivot table. + + +Select a field member in the pop-up window and click the Hide only the current item button to hide only the selected field member. All other field members are shown in the pivot table. + + +Commands enable you to sort the field members in ascending order, descending order, or using a custom sort list. + + +To edit the custom sort lists, open %PRODUCTNAME - Preferences +Tools - Options - %PRODUCTNAME Calc - Sort Lists. + + +The arrow to open the pop-up window is normally black. When the field contains one or more hidden field members, the arrow is blue and displays a tiny square at its lower-right corner. + + +You can also open the pop-up window by positioning the cell cursor at the button and pressing Command +Ctrl+D. + + + +
+ + + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_formatting.xhp b/helpcontent2/source/text/scalc/guide/datapilot_formatting.xhp new file mode 100644 index 000000000..820623004 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_formatting.xhp @@ -0,0 +1,64 @@ + + + + + + + Formatting Pivot Tables + /text/scalc/guide/datapilot_formatting.xhp + + + +
+ + formatting;pivot tables + +

Formatting Pivot Tables

+ You can format pivot tables cells using specific cell styles. +
+ Direct formatting of pivot tables cells is lost when updating or editing the table. + When creating a pivot table, six new cell styles are added to your document. Format each cell style as needed. The customization of the pivot cell styles will be preserved when updating the pivot table. + By using cell styles for pivot table formatting, all pivot tables cells in the spreadsheet document will have the same look. In other words, the pivot table cell styles apply to all pivot tables of the document. + The six cell styles are: + + + Pivot Table Categories + + + Pivot Table Corner + + + Pivot Table Field + + + Pivot Table Result + + + Pivot Table Value + + + Pivot Table Title + + + The number format of these cell styles cannot be changed in the cell style itself; you must format it in the data source. + +
+ + + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_grouping.xhp b/helpcontent2/source/text/scalc/guide/datapilot_grouping.xhp new file mode 100644 index 000000000..174101cfe --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_grouping.xhp @@ -0,0 +1,61 @@ + + + + + +Grouping Pivot Tables +/text/scalc/guide/datapilot_grouping.xhp + + + +grouping; pivot tables +pivot table function;grouping table entries +ungrouping entries in pivot tables + +

Grouping Pivot Tables +

see http://specs.openoffice.org/calc/compatibility/grouping.sxwThe resulting pivot table can contain many different entries. By grouping the entries, you can improve the visible result. + + +Select a cell or range of cells in the pivot table. + + +Choose Data - Group and Outline - Group. + + +Depending on the format of the selected cells, either a new group field is added to the pivot table, or you see one of the two Grouping dialogs, either for numeric values, or for date values. +The pivot table must be organized in a way that grouping can be applied. + + +To remove a grouping, click inside the group, then choose Data - Group and Outline - Ungroup. + + + + +
+ + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_tipps.xhp b/helpcontent2/source/text/scalc/guide/datapilot_tipps.xhp new file mode 100644 index 000000000..9966532b1 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_tipps.xhp @@ -0,0 +1,50 @@ + + + + + +Selecting Pivot Table Output Ranges +/text/scalc/guide/datapilot_tipps.xhp + + + +pivot table function; preventing data overwriting +output ranges of pivot tables + +

Selecting Pivot Table Output Ranges +

+Click the button More in the Pivot Table dialog. The dialog will be extended. +You can select a named range in which the pivot table is to be created, from the Results to box. If the results range does not have a name, enter the coordinates of the upper left cell of the range into the field to the right of the Results to box. You can also click on the appropriate cell to have the coordinates entered accordingly. +If you mark the Ignore empty rows check box, they will not be taken into account when the pivot table is created. +If the Identify categories check box is marked, the categories will be identified by their headings and assigned accordingly when the pivot table is created. + + +
+ + + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/datapilot_updatetable.xhp b/helpcontent2/source/text/scalc/guide/datapilot_updatetable.xhp new file mode 100644 index 000000000..9d9beea68 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/datapilot_updatetable.xhp @@ -0,0 +1,49 @@ + + + + + +Updating Pivot Tables +/text/scalc/guide/datapilot_updatetable.xhp + + + +pivot table import +pivot table function; refreshing tables +recalculating;pivot tables +updating;pivot tables + +

Updating Pivot Tables +

+If the data of the source sheet has been changed, $[officename] recalculates the pivot table. To recalculate the table, choose Data - Pivot Table - Refresh. Do the same after you have imported an Excel pivot table into $[officename] Calc. + + +
+ + + + + + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/dbase_files.xhp b/helpcontent2/source/text/scalc/guide/dbase_files.xhp new file mode 100644 index 000000000..79f3c9802 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/dbase_files.xhp @@ -0,0 +1,106 @@ + + + + + + + + + Importing and Exporting dBASE Files + /text/scalc/guide/dbase_files.xhp + + + +exporting;spreadsheets to dBASE + importing;dBASE files + dBASE import/export + spreadsheets; importing from/exporting to dBASE files + tables in databases;importing dBASE files +mw changed "database tables;" to "tables in databases;" and reduced "spreadsheets;" from two to one entry +Importing and Exporting dBASE Files + + You can open and save data in the dBASE file format (*.dbf file extension) in $[officename] Base or a spreadsheet. In %PRODUCTNAME Base, a dBASE database is a folder that contains files with the .dbf file extension. Each file corresponds to a table in the database. Formulas and formatting are lost when you open and save a dBASE file from %PRODUCTNAME. + To Import a dBASE File Into a Spreadsheet + + + Choose File - Open. + + + Locate the *.dbf file that you want to import. + + + Click Open. + The Import dBASE files dialog opens. + + + Click OK. + The dBASE file opens as a new Calc spreadsheet. + If you want to save the spreadsheet as a dBASE file, do not alter or delete the first row in the imported file. This row contains information that is required by a dBASE database. + + + To Import a dBASE File Into a Database Table + A %PRODUCTNAME Base database table is actually a link to an existing database. + + + Choose File - New - Database. + + + In the File name box of the Save As dialog, enter a name for the database. + + + Click Save. + + + In the Database type box of the Database Properties dialog, select "dBASE". + + + Click Next. + + + Click Browse. + + + Locate the directory that contains the dBASE file, and click OK. + + + Click Create. + + + To Save a Spreadsheet as a dBASE File + + + Choose File - Save As. + + + In the File format box, select "dBASE file". + + + In the File name box, type a name for the dBASE file. + + + Click Save. + + + Only the data on the current sheet is exported. +
+ + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/design.xhp b/helpcontent2/source/text/scalc/guide/design.xhp new file mode 100644 index 000000000..0674f5353 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/design.xhp @@ -0,0 +1,72 @@ + + + + + + + + + + +Selecting Themes for Sheets +/text/scalc/guide/design.xhp + + + + + + +theme selection for sheets +layout;spreadsheets +cell styles; selecting +selecting;formatting themes +sheets;formatting themes +formats;themes for sheets +formatting;themes for sheets + + mw deleted "applying;" + Selecting Themes for Sheets + + $[officename] Calc comes with a predefined set of formatting themes that you can apply to your spreadsheets. + It is not possible to add themes to Calc, and they cannot be modified. However, you can modify their styles after you apply them to a spreadsheet. + Before you format a sheet with a theme, you have to apply at least one custom cell style to the cells on the sheet. You can then change the cell formatting by selecting and applying a theme in the Theme Selection dialog. + To apply a custom cell style to a cell, you can open the Styles window and, in its lower list box, set the Custom Styles view. A list of the existing custom defined cell styles will be displayed. Double click a name from the Styles window to apply this style to the selected cells. + To apply a theme to a spreadsheet: + + + Click the Choose Themes icon in the Tools bar. + + The Theme Selection dialog appears. This dialog lists the available themes for the whole spreadsheet and the Styles window lists the custom styles for specific cells. + + + In the Theme Selection dialog, select the theme that you want to apply to the spreadsheet. + + + Click OK + As soon as you select another theme in the Theme Selection dialog, some of the properties of the custom style will be applied to the current spreadsheet. The modifications will be immediately visible in your spreadsheet. + + +
+ + + Theme selection + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/edit_multitables.xhp b/helpcontent2/source/text/scalc/guide/edit_multitables.xhp new file mode 100644 index 000000000..e889dc392 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/edit_multitables.xhp @@ -0,0 +1,51 @@ + + + + + + + Copying to Multiple Sheets + /text/scalc/guide/edit_multitables.xhp + + + + +copying;values, to multiple sheets +pasting;values in multiple sheets +data;inserting in multiple sheets +sheets; simultaneous multiple filling + + mw moved "multiple sheets" and "selecting;" to multitables.xhp, transferred "sheets;" from there and deleted "sheets;transferring.." +Copying to Multiple Sheets + In $[officename] Calc, you can insert values, text or formulas that are simultaneously copied to other selected sheets of your document. + + + Select all desired sheets by holding down the CommandCtrl key and clicking the corresponding register tabs that are still gray at the bottom margin of the workspace. All selected register tabs are now white. + You can use Shift+CommandCtrl+Page Up or Page Down to select multiple sheets using the keyboard. + + + Now when you insert values, text or formulas into the active sheet, they will also appear in the identical positions in the other selected sheets. For example, data entered in cell "A1" of the active sheet is automatically entered into cell "A1" of any other selected sheet. + + +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/filters.xhp b/helpcontent2/source/text/scalc/guide/filters.xhp new file mode 100644 index 000000000..fb120422e --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/filters.xhp @@ -0,0 +1,57 @@ + + + + + + + + + Applying Filters + /text/scalc/guide/filters.xhp + + + +filters; applying/removing + rows;removing/redisplaying with filters + removing;filters + +Applying Filters + + Filters and advanced filters allow you to work on certain filtered rows (records) of a data range. In the spreadsheets in $[officename] there are various possibilities for applying filters. + + + One use for the AutoFilter function is to quickly restrict the display to records with identical entries in a data field. + + + In the Standard Filter dialog, you can also define ranges which contain the values in particular data fields. You can use the standard filter to connect the conditions with either a logical AND or a logical OR operator. + + + The Advanced filter allows up to a total of eight filter conditions. With advanced filters you enter the conditions directly into the sheet. + + + To remove a filter, so that you see all cells again, click inside the area where the filter was applied, then choose Data - Filter - Reset Filter. + When you select multiple rows from an area where a filter was applied, then this selection can include rows that are visible and rows that are hidden by the filter. If you then apply formatting, or delete the selected rows, this action then applies only to the visible rows. The hidden rows are not affected. + This is the opposite to rows that you have hidden manually by the Format - Rows - Hide Rows command. Manually hidden rows are deleted when you delete a selection that contains them. +
+ + + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/finding.xhp b/helpcontent2/source/text/scalc/guide/finding.xhp new file mode 100644 index 000000000..bc55cf5c2 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/finding.xhp @@ -0,0 +1,94 @@ + + + + + + + + +Finding and Replacing in Calc +/text/scalc/guide/finding.xhp + + + +
+searching, see also finding +finding;formulas/values/text/objects +replacing; cell contents +formatting;multiple cell texts +2. mw deleted 2 entries, changed "finding;" and added "formatting;"1. mw copied 5 entries from shared/01/02100000.xhp and changed then "finding," and "replacing;" +Finding and Replacing in Calc + +In spreadsheet documents you can find words, formulas, and styles. You can navigate from one result to the next, or you can highlight all matching cells at once, then apply another format or replace the cell content by other content. +
+The Find & Replace dialog +Cells can contain text or numbers that were entered directly as in a text document. But cells can also contain text or numbers as the result of a calculation. For example, if a cell contains the formula =1+2 it displays the result 3. You must decide whether to search for the 1 respective 2, or to search the 3. +To find formulas or values +You can specify in the Find & Replace dialog either to find the parts of a formula or the results of a calculation. + + +Choose Edit - Find & Replace to open the Find & Replace dialog. + + +Click More Options to expand the dialog. + + +Select "Formulas" or "Values" in the Search in list box. + + +With "Formulas" you will find all parts of the formulas. +With "Values" you will find the results of the calculations. +Cell contents can be formatted in different ways. For example, a number can be formatted as a currency, to be displayed with a currency symbol. These symbols are included in searches when the Formatted Display search option is activated. +Finding text + + +Choose Edit - Find & Replace to open the Find & Replace dialog. + + +Enter the text to find in the Find text box. + + +Either click Find Next or Find All. + + +When you click Find Next, Calc will select the next cell that contains your text. You can watch and edit the text, then click Find Next again to advance to the next found cell. + + +If you closed the dialog, you can press a key combination (CommandCtrl+Shift+F) to find the next cell without opening the dialog. + + +By default, Calc searches the current sheet. Check the All sheets box to search through all sheets of the document. + + +When you click Find All, Calc selects all cells that contain your entry. Now you can for example set all found cells to bold, or apply a Cell Style to all at once. +The Navigator + + +Choose View - Navigator to open the Navigator window. + + +The Navigator is the main tool for finding and selecting objects. +Use the Navigator for inserting objects and links within the same document or from other open documents. +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/format_table.xhp b/helpcontent2/source/text/scalc/guide/format_table.xhp new file mode 100644 index 000000000..2d3892675 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/format_table.xhp @@ -0,0 +1,76 @@ + + + + + + + + + +Formatting Spreadsheets +/text/scalc/guide/format_table.xhp + + + +text in cells; formatting +spreadsheets;formatting +backgrounds;cells and pages +borders;cells and pages +formatting;spreadsheets +numbers; formatting options for selected cells +cells; number formats +currencies;formats +mw transferred 2 entries from shared/01/05020300.xhp and added 2 new entriesmw deleted "defaults;" +Formatting Spreadsheets + +Formatting Text in a Spreadsheet + + +Select the text you want to format. + + +Choose the desired text attributes from the Formatting Bar. You can also choose Format - Cells. The Format Cells dialog will appear in which you can choose various text attributes on the Font tab page. + + +Formatting Numbers in a Spreadsheet + + +Select the cells containing the numbers you want to format. + + +To format numbers in the default currency format or as percentages, use the icons on the Formatting Bar. For other formats, choose Format - Cells. You can choose from the preset formats or define your own on the Numbers tab page. + + +Formatting Borders and Backgrounds for Cells and Pages + + +You can assign a format to any group of cells by first selecting the cells (for multiple selection, hold down the CommandCtrl key when clicking), and then activating the Format Cells dialog in Format - Cells. In this dialog, you can select attributes such as shadows and backgrounds. + + +To apply formatting attributes to an entire sheet, choose Format - Page. You can define headers and footers, for example, to appear on each printed page. + + +An image that you have loaded with Format - Page - Background is only visible in print or in the print preview. To display a background image on screen as well, insert the graphic image by choosing Insert - Image - From File and arrange the image behind the cells by choosing Format - Arrange - To Background. Use the Navigator to select the background image. +
+ +Number Formatting Options +Backgrounds for Cells +
+ + diff --git a/helpcontent2/source/text/scalc/guide/format_value.xhp b/helpcontent2/source/text/scalc/guide/format_value.xhp new file mode 100644 index 000000000..852f4b26a --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/format_value.xhp @@ -0,0 +1,73 @@ + + + + + + + + + Formatting Numbers With Decimals + /text/scalc/guide/format_value.xhp + + + +numbers;formatting decimals + formats; numbers in tables + tables; number formats + defaults; number formats in spreadsheets + decimal places;formatting numbers + formatting;numbers with decimals + formatting;adding/deleting decimal places + number formats; adding/deleting decimal places in cells + deleting; decimal places + decimal places; adding/deleting +mw changed "numbers;" +Formatting Numbers With Decimals + + Enter a number into the sheet, for example, 1234.5678. This number will be displayed in the default number format, with two decimal places. You will see 1234.57 when you confirm the entry. Only the display in the document will be rounded off; internally, the number retains all four decimal places after the decimal point. + To format numbers with decimals: + + + Set the cursor at the number and choose Format - Cells to start the Format Cells dialog. + + + On the Numbers tab you will see a selection of predefined number formats. In the bottom right in the dialog you will see a preview of how your current number would look if you were to give it a particular format. + + + + + + +Icon + + + + If you only want to modify the number of the decimal places displayed, the easiest method is to use the Number Format: Add Decimal Place or Number Format: Delete Decimal Place icons on the Formatting Bar. + + +
+ +
+ + + + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/format_value_userdef.xhp b/helpcontent2/source/text/scalc/guide/format_value_userdef.xhp new file mode 100644 index 000000000..7e3a94932 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/format_value_userdef.xhp @@ -0,0 +1,124 @@ + + + + + + + + + User-defined Number Formats + /text/scalc/guide/format_value_userdef.xhp + + + +numbers;user-defined formatting + formatting; user-defined numbers + number formats; millions + format codes; user-defined number formats +mw changed "numbers;" +User-defined Number Formats + + You can define your own number formats to display numbers in %PRODUCTNAME Calc. + As an example, to display the number 10,200,000 as 10.2 Million: + + + Select the cells to which you want to apply a new, user-defined format. + + + Choose Format - Cells - Numbers. + + + In the Categories list box select "User-defined". + + + In the Format code text box enter the following code: + 0.0,, "Million" + + + Click OK. + + + The following table shows the effects of rounding, thousands delimiters (,), decimal delimiters (.) and the placeholders # and 0. + + + + Number + + + .#,, "Million" + + + 0.0,, "Million" + + + #,, "Million" + + + + + 10200000 + + + 10.2 Million + + + 10.2 Million + + + 10 Million + + + + + 500000 + + + .5 Million + + + 0.5 Million + + + 1 Million + + + + + 100000000 + + + 100. Million + + + 100.0 Million + + + 100 Million + + +
+ +
+ + + + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/formula_copy.xhp b/helpcontent2/source/text/scalc/guide/formula_copy.xhp new file mode 100644 index 000000000..0a1fe693d --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/formula_copy.xhp @@ -0,0 +1,76 @@ + + + + + + + + +Copying Formulas +/text/scalc/guide/formula_copy.xhp + + +Sun Microsystems, Inc. + + + +formulas; copying and pasting +copying; formulas +pasting;formulas +mw added "pasting;" and changed "formulas;" +Copying Formulas + +
+There are various ways to copy a formula. One suggested method is: + + +Select the cell containing the formula. + + +Choose Edit - Copy, or press CommandCtrl+C to copy it. + + +Select the cell into which you want the formula to be copied. + + +Choose Edit - Paste, or press CommandCtrl+V. The formula will be positioned in the new cell. + + +If you want to copy a formula into multiple cells, there is a quick and easy way to copy into adjacent cell areas: + + +Select the cell containing the formula. + + +Position the mouse on the bottom right of the highlighted border of the cell, and continue holding down the mouse button until the pointer changes to a cross-hair symbol. + + +With the mouse button pressed, drag it down or to the right over all the cells into which you want to copy the formula. + + +When you release the mouse button, the formula will be copied into the cells and automatically adjusted. + + +If you do not want values and texts to be automatically adjusted, then hold down the CommandCtrl key when dragging. Formulas, however, are always adjusted accordingly. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/formula_enter.xhp b/helpcontent2/source/text/scalc/guide/formula_enter.xhp new file mode 100644 index 000000000..1ea5acb80 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/formula_enter.xhp @@ -0,0 +1,68 @@ + + + + + + + + + + +Entering Formulas +/text/scalc/guide/formula_enter.xhp + + + +formula bar; input line +input line in formula bar +formulas; inputting +inserting;formulas + +Entering Formulas + +You can enter formulas in several ways: using the icons, or by typing on the keyboard, or by a mixture of both methods. + + +Click the cell in which you want to enter the formula. + + +Click the Function icon on the Formula Bar. +You will now see an equals sign in the input line and you can begin to input the formula. + + +After entering the required values, press Enter or click Accept to insert the result in the active cell. If you want to clear your entry in the input line, press Escape or click Cancel. + + +You can also enter the values and the formulas directly into the cells, even if you cannot see an input cursor. Formulas must always begin with an equals sign. +You can also press the + or - key on the numerical keyboard to start a formula. NumLock must be "on". For example, press the following keys in succession: ++ 5 0 - 8 Enter +You see the result 42 in the cell. The cell contains the formula =+50-8. +If you are editing a formula with references, the references and the associated cells will be highlighted with the same color. You can now resize the reference border using the mouse, and the reference in the formula displayed in the input line also changes. Show references in color can be deactivated under %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View. +If you would like to view the calculation of individual elements of a formula, select the respective elements and press F9. For example, in the formula =SUM(A1:B12)*SUM(C1:D12) select the section SUM(C1:D12) and press F9 to view the subtotal for this area. + +If an error occurs when creating the formula, an error message appears in the active cell. +
+ +Formula bar + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/formula_value.xhp b/helpcontent2/source/text/scalc/guide/formula_value.xhp new file mode 100644 index 000000000..e125921f0 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/formula_value.xhp @@ -0,0 +1,55 @@ + + + + + + + + +Displaying Formulas or Values +/text/scalc/guide/formula_value.xhp + + +Sun Microsystems, Inc. + + + +formulas; displaying in cells +values; displaying in tables +tables; displaying formulas/values +results display vs. formulas display +displaying; formulas instead of results +mw inserted "displaying;..." entry from shared/optionen/01060100.xhp. Adding (Calc) is no longer necessary in this file. mw made "results;..." a two level entry. +Displaying Formulas or Values + +If you want to display the formulas in the cells, for example in the form =SUM(A1:B5), proceed as follows: + + +Choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View. + + +In the Display area mark the Formulas box. Click OK. + + +If you want to view the calculation results instead of the formula, do not mark the Formulas box. +
+%PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View +
+ + diff --git a/helpcontent2/source/text/scalc/guide/formulas.xhp b/helpcontent2/source/text/scalc/guide/formulas.xhp new file mode 100644 index 000000000..acc8ae6b0 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/formulas.xhp @@ -0,0 +1,106 @@ + + + + + + + + + + +Calculating With Formulas +/text/scalc/guide/formulas.xhp + + + +formulas;calculating with +calculating; with formulas +examples;formula calculation +Calculating With Formulas + +All formulas begin with an equals sign. The formulas can contain numbers, text, arithmetic operators, logic operators, or functions. +Remember that the basic arithmetic operators (+, -, *, /) can be used in formulas using the "Multiplication and Division before Addition and Subtraction" rule. Instead of writing =SUM(A1:B1) you can write =A1+B1. +Parentheses can also be used. The result of the formula =(1+2)*3 produces a different result than =1+2*3. +Here are a few examples of $[officename] Calc formulas: + + + +=A1+10 + + +Displays the contents of cell A1 plus 10. + + + + +=A1*16% + + +Displays 16% of the contents of A1. + + + + +=A1 * A2 + + +Displays the result of the multiplication of A1 and A2. + + + + +=ROUND(A1;1) + + +Displays the contents of cell A1 rounded to one decimal place. + + + + +=EFFECTIVE(5%;12) + + +Calculates the effective interest for 5% annual nominal interest with 12 payments a year. + + + + +=B8-SUM(B10:B14) + + +Calculates B8 minus the sum of the cells B10 to B14. + + + + +=SUM(B8;SUM(B10:B14)) + + +Calculates the sum of cells B10 to B14 and adds the value to B8. + + +
+It is also possible to nest functions in formulas, as shown in the example. You can also nest functions within functions. The Function Wizard assists you with nested functions. +
+ +Functions list +Function Wizard +
+ + diff --git a/helpcontent2/source/text/scalc/guide/fraction_enter.xhp b/helpcontent2/source/text/scalc/guide/fraction_enter.xhp new file mode 100644 index 000000000..b3917bafb --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/fraction_enter.xhp @@ -0,0 +1,53 @@ + + + + + + + + +Entering Fractions +/text/scalc/guide/fraction_enter.xhp + + +Sun Microsystems, Inc. + + + +fractions; entering +numbers; entering fractions +inserting;fractions + +Entering Fractions + +
+You can enter a fractional number in a cell and use it for calculation: + + +Enter "0 1/5" in a cell (without the quotation marks) and press the input key. In the input line above the spreadsheet you will see the value 0.2, which is used for the calculation. + + +If you enter “0 1/2” AutoCorrect causes the three characters 1, / and 2 to be replaced by a single character, ½. The same applies to 1/4 and 3/4. This replacement is defined in Tools - AutoCorrect - AutoCorrect Options - Options tab. +If you want to see multi-digit fractions such as "1/10", you must change the cell format to the multi-digit fraction view. Open the context menu of the cell, and choose Format cells. Select "Fraction" from the Category field, and then select "-1234 10/81". You can then enter fractions such as 12/31 or 12/32 - the fractions are, however, automatically reduced, so that in the last example you would see 3/8. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/goalseek.xhp b/helpcontent2/source/text/scalc/guide/goalseek.xhp new file mode 100644 index 000000000..69a77fb33 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/goalseek.xhp @@ -0,0 +1,66 @@ + + + + + + + + + +Applying Goal Seek +/text/scalc/guide/goalseek.xhp + + + +goal seeking;example +equations in goal seek +calculating;variables in equations +variables;calculating equations +examples;goal seek +mw changed "goal seek example" to "goal seeking;" +Applying Goal Seek + +With the help of Goal Seek you can calculate a value that, as part of a formula, leads to the result you specify for the formula. You thus define the formula with several fixed values and one variable value and the result of the formula. +Goal Seek Example +To calculate annual interest (I), create a table with the values for the capital (C), number of years (n), and interest rate (i). The formula is: +I = C * n* i +Let us assume that the interest rate i of 7.5% and the number of years n (1) will remain constant. However, you want to know how much the investment capital C would have to be modified in order to attain a particular return I. For this example, calculate how much capital C would be required if you want an annual return of $15,000. +Enter each of the values for Capital C (an arbitrary value like $100,000), number of years n (1), and interest rate i (7.5%) in one cell each. Enter the formula to calculate the interest I in another cell. Instead of C, n, and i use the reference to the cell with the corresponding value. + + +Place the cursor in the cell containing the interest I, and choose Tools - Goal Seek. The Goal Seek dialog appears. + + +The correct cell is already entered in the field Formula Cell. + + +Place the cursor in the field Variable Cell. In the sheet, click in the cell that contains the value to be changed, in this example it is the cell with the capital value C. + + +Enter the expected result of the formula in the Target Value text box. In this example, the value is 15,000. Click OK. + + +A dialog appears informing you that the Goal Seek was successful. Click Yes to enter the result in the cell with the variable value. + + +
+Goal Seek +
+ + diff --git a/helpcontent2/source/text/scalc/guide/html_doc.xhp b/helpcontent2/source/text/scalc/guide/html_doc.xhp new file mode 100644 index 000000000..2a98b9e9e --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/html_doc.xhp @@ -0,0 +1,71 @@ + + + + + + + + + + +Saving and Opening Sheets in HTML +/text/scalc/guide/html_doc.xhp + + + +HTML; sheets +sheets; HTML +saving; sheets in HTML +opening; sheets in HTML + +Saving and Opening Sheets in HTML + +Saving Sheets in HTML + +%PRODUCTNAME Calc saves all the sheets of a Calc document together as an HTML document. At the beginning of the HTML document, a heading and a list of hyperlinks are automatically added which lead to the individual sheets within the document. +Numbers are shown as written. In addition, in the <SDVAL> HTML tag, the exact internal number value is written so that after opening the HTML document with %PRODUCTNAME you know you have the exact values. + + +To save the current Calc document as HTML, choose File - Save As. + + +In the File type list box, in the area with the other %PRODUCTNAME Calc filters, choose the file type "HTML Document (%PRODUCTNAME Calc)". + + +Enter a File name and click Save. + + +Opening Sheets in HTML + +%PRODUCTNAME offers various filters for opening HTML files, which you can select under File - Open in the Files of type list box: + + +Choose the file type "HTML Document (%PRODUCTNAME Calc)" to open in %PRODUCTNAME Calc. +All %PRODUCTNAME Calc options are now available to you. However, not all options that %PRODUCTNAME Calc offers for editing can be saved in HTML format. + + +
+ + + +File - Open +File - Save As +
+ + diff --git a/helpcontent2/source/text/scalc/guide/integer_leading_zero.xhp b/helpcontent2/source/text/scalc/guide/integer_leading_zero.xhp new file mode 100644 index 000000000..8380d830b --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/integer_leading_zero.xhp @@ -0,0 +1,88 @@ + + + + + + + Entering a Number with Leading Zeros + /text/scalc/guide/integer_leading_zero.xhp + + + + + + + zero values; entering leading zeros + numbers; with leading zeros + leading zeros + integers with leading zeros + cells; changing text/number formats + formats; changing text/number + text in cells; changing to numbers + converting;text with leading zeros, into numbers + +UFI: inserted "converting;text to numbers"mw changed "converting;" and deleted "numbers,changing..." + +Entering a Number with Leading Zeros + +
+There are various ways to enter integers starting with a zero: + + + + Enter the number as text. The easiest way is to enter the number starting with an apostrophe (for example, '0987). The apostrophe will not appear in the cell, and the number will be formatted as text. Because it is in text format, however, you cannot calculate with this number. + + + Format a cell with a number format such as \0000. This format can be assigned in the Format code field under the Format - Cells - Numbers tab, and defines the cell display as "always put a zero first and then the integer, having at least three places, and filled with zeros at the left if less than three digits". + + +If you want to apply a numerical format to a column of numbers in text format (for example, text "000123" becomes number "123"), do the following: + + + + Select the column in which the digits are found in text format. Set the cell format in that column as "Number". + + + Choose Edit - Find & Replace + + + In the Find box, enter ^[0-9] + + + In the Replace box, enter & + + + Check Regular expressions + + + Check Current selection only + + + Click Replace All + + +
+ +
+ + +
+ + + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/keyboard.xhp b/helpcontent2/source/text/scalc/guide/keyboard.xhp new file mode 100644 index 000000000..e827a77a9 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/keyboard.xhp @@ -0,0 +1,105 @@ + + + + + + + + +Shortcut Keys (%PRODUCTNAME Calc Accessibility) +/text/scalc/guide/keyboard.xhp + + +Sun Microsystems, Inc. + + + +accessibility; %PRODUCTNAME Calc shortcuts +shortcut keys;%PRODUCTNAME Calc accessibility + +Shortcut Keys (%PRODUCTNAME Calc Accessibility) + +Refer also to the lists of shortcut keys for %PRODUCTNAME Calc and %PRODUCTNAME in general. + +Cell Selection Mode + + + + +Icon + + + +In a text box that has a button to minimize the dialog, press F2 to enter the cell selection mode. Select any number of cells, then press F2 again to show the dialog. + + +
+ +In the cell selection mode, you can use the common navigation keys to select cells. +Controlling the Outline +You can use the keyboard in Outline: + + +Press F6 or Shift+F6 until the vertical or horizontal outline window has the focus. + + + +Tab - cycle through all visible buttons from top to bottom or from left to right. + + + +Shift+Tab - cycle through all visible buttons in the opposite direction. + + + +Command+1 to Command+8Ctrl+1 to Ctrl+8 - show all levels up to the specified number; hide all higher levels. + + +Use + or - to show or hide the focused outline group. + + +Press Enter to activate the focused button. + + +Use Up, Down, Left, or Right arrow to cycle through all buttons in the current level. + + +Selecting a Drawing Object or a Graphic + + +Choose View - Toolbars - Drawing to open the Drawing toolbar. + + +Press F6 until the Drawing toolbar is selected. + + +If the selection tool is active, press CommandCtrl+Enter. This selects the first drawing object or graphic in the sheet. + + +With CommandCtrl+F6 you set the focus to the document. +Now you can use Tab to select the next drawing object or graphic and Shift+Tab to select the previous one. + + +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/line_fix.xhp b/helpcontent2/source/text/scalc/guide/line_fix.xhp new file mode 100644 index 000000000..688669bad --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/line_fix.xhp @@ -0,0 +1,67 @@ + + + + + + + Freezing Rows or Columns as Headers + /text/scalc/guide/line_fix.xhp + + + + + + + tables; freezing + title rows; freezing during table split + rows; freezing + columns; freezing + freezing rows or columns + headers; freezing during table split + scrolling prevention in tables + windows; splitting + tables; splitting windows + + + +

Freezing Rows or Columns as Headers

+If you have long rows or columns of data that extend beyond the viewable area of the sheet, you can freeze some rows or columns, which allows you to see the frozen columns or rows as you scroll through the rest of the data. + + + + Select the row below, or the column to the right of the row or column that you want to be in the frozen region. All rows above, or all columns to the left of the selection are frozen. + To freeze both horizontally and vertically, select the cell that is below the row and to the right of the column that you want to freeze. + + + Choose View - Freeze Rows and Columns. + To deactivate, choose View - Freeze Rows and Columns again. + + +If the area defined is to be scrollable, apply the View - Split Window command. +If you want to print a certain row on all pages of a document, choose Format - Print ranges - Edit. + +
+View - Freeze Rows and Columns +View - Split Window + +Format - Print ranges - Edit +
+ + + diff --git a/helpcontent2/source/text/scalc/guide/main.xhp b/helpcontent2/source/text/scalc/guide/main.xhp new file mode 100644 index 000000000..771a35c2b --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/main.xhp @@ -0,0 +1,152 @@ + + + + + + + + + + +Instructions for Using $[officename] Calc +/text/scalc/guide/main.xhp + + + +HowTos for Calc +instructions; $[officename] Calc +MWdeleted one entry and added oneInstructions for Using $[officename] Calc + + +Formatting Tables and Cells + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Entering Values and Formulas + + + + + + + + + + + + + + + + + + + + + +Entering Referencesmw deleted link to Calc guide address_byname.xhp + + + + + + + + +Database Ranges in Tables + + + +Advanced Calculations + + + + + + + + + + + + +Printing and Print Preview + + + + + + +Importing and Exporting Documents + + + + + + + +Miscellaneous + + + + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/guide/mark_cells.xhp b/helpcontent2/source/text/scalc/guide/mark_cells.xhp new file mode 100644 index 000000000..ab777c706 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/mark_cells.xhp @@ -0,0 +1,104 @@ + + + + + + + + + Selecting Multiple Cells + /text/scalc/guide/mark_cells.xhp + + + +cells; selecting + marking cells + selecting;cells + multiple cells selection + selection modes in spreadsheets + tables; selecting ranges +mw changed "selection modes..." +Selecting Multiple Cells + + Select a rectangular range + With the mouse button pressed, drag from one corner to the diagonally opposed corner of the range. + Mark a single cell + Do one of the following: + + + Click, then Shift-click the cell. + + + Pressing the mouse button, drag a range across two cells, do not release the mouse button, and then drag back to the first cell. Release the mouse button. You can now move the individual cell by drag and drop. + + + Select various dispersed cells + Do one of the following: + + + Mark at least one cell. Then while pressing Command +Ctrl, click each of the additional cells. + + + Click the STD / EXT / ADD area in the status bar until it shows ADD. Now click all cells that you want to select. + + + Switch marking mode + On the status bar, click the box with the legend STD / EXT / ADD to switch the marking mode: + + + + Field contents + + + Effect of clicking the mouse + + + + + STD + + + A mouse click selects the cell you have clicked on. Unmarks all marked cells. + + + + + EXT + + + A mouse click marks a rectangular range from the current cell to the cell you clicked. Alternatively, Shift-click a cell. + + + + + ADD + + + A mouse click in a cell adds it to the already marked cells. A mouse click in a marked cell unmarks it. Alternatively, Command +Ctrl-click the cells. + + +
+ +
+ Status bar +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/matrixformula.xhp b/helpcontent2/source/text/scalc/guide/matrixformula.xhp new file mode 100644 index 000000000..8766483f1 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/matrixformula.xhp @@ -0,0 +1,69 @@ + + + + + + + + +Entering Matrix Formulas +/text/scalc/guide/matrixformula.xhp + + +Sun Microsystems, Inc. + + + +matrices; entering matrix formulas +formulas; matrix formulas +inserting;matrix formulas + +Entering Matrix Formulas + +The following is an example of how you can enter a matrix formula, without going into the details of matrix functions. +Assume you have entered 10 numbers in Columns A and B (A1:A10 and B1:B10), and would like to calculate the sum of each row in Column C. + + +Using the mouse, select the range C1:C10, in which the results are to be displayed. + + +Press F2, or click in the input line of the Formula bar. + + +Enter an equal sign (=). + + +Select the range A1:A10, which contains the first values for the sum formula. + + +Press the (+) key from the numerical keypad. + + +Select the numbers in the second column in cells B1:B10. + + +End the input with the matrix key combination: Shift+CommandCtrl+Enter. + + +The matrix area is automatically protected against modifications, such as deleting rows or columns. It is, however, possible to edit any formatting, such as the cell background. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/move_dragdrop.xhp b/helpcontent2/source/text/scalc/guide/move_dragdrop.xhp new file mode 100644 index 000000000..a89af2096 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/move_dragdrop.xhp @@ -0,0 +1,121 @@ + + + + + + + + +Moving Cells by Drag-and-Drop +/text/scalc/guide/move_dragdrop.xhp + + + +drag and drop; moving cells +cells; moving by drag and drop +rows;moving by drag and drop +columns;moving by drag and drop +moving;cells, rows and columns by drag and drop +inserting;cells, by drag and drop +mw added "columns;" +Moving Cells by Drag-and-Drop + +When you drag-and-drop a selection of cells, rows or columns on a Calc sheet, the cells (including the ones in selected rows or columns) normally overwrite the existing cells in the area where you drop. This is the normal overwrite mode. +Note that to drag-and-drop entire rows or columns, you must select the rows or columns you want to move (or copy) first, then start dragging from selected cells, not from the row or column headers (cells would be deselected by this). +When you hold down the OptionAlt key while releasing the mouse button, you enter the insert mode. + + +In insert mode, the existing cells where you drop will be shifted to the right or to the bottom, and the dropped cells are inserted into the now empty positions without overwriting. + + +The surrounding box of the moved cells looks different in insert mode. +In overwrite mode you see all four borders around the selected area. In insert mode you see only the left border when target cells will be shifted to the right. You see only the upper border when target cells will be shifted down. +Whether the target area will be shifted to the right or to the bottom depends on the distance between source and target cells, if you move within the same sheet. It depends on the number of horizontal or vertical cells in the moved area, if you move to a different sheet. + + +If you move cells in insert mode within the same row (only horizontally), then after insertion of the cells, all cells will be shifted to the left to fill the source area. + + +In both modes, you can hold down the CommandCtrl key, or CommandCtrl+Shift keys while you release the mouse button to insert a copy or a link, respectively. + + + +Keys pressed while releasing the mouse button + + +Result + + + + +No key + + +Cells are moved and overwrite the cells in the target area. Source cells are emptied. + + + + +CommandCtrl key + + +Cells are copied and overwrite the cells in the target area. Source cells stay as they are. + + + + +CommandCtrl+Shift keys + + +Links to the source cells are inserted and overwrite the cells in the target area. Source cells stay as they are. + + + + +OptionAlt key + + +Cells are moved and shift the cells in the target area to the right or to the bottom. Source cells are emptied, except if you move within the same rows on the same sheet. +If you move within the same rows on the same sheet, the cells in the target area shift to the right, and then the whole row shifts to fill the source area. + + + + +Option+Command Alt+Ctrl keys + + +Cells are copied and shift the cells in the target area to the right or to the bottom. Source cells stay as they are. + + + + +Option+CommandAlt+Ctrl+Shift keys + + +Links to the source cells are inserted and shift the cells in the target area to the right or to the bottom. Source cells stay as they are. + + +
+ +
+ + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/multi_tables.xhp b/helpcontent2/source/text/scalc/guide/multi_tables.xhp new file mode 100644 index 000000000..54efa74b1 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/multi_tables.xhp @@ -0,0 +1,66 @@ + + + + + + + + + + +Navigating Through Sheets Tabs +/text/scalc/guide/multi_tables.xhp + + + + + + +sheets; showing multiple +sheet tabs;using +views;multiple sheets + + Navigating Through Sheet Tabs + + By default $[officename] displays three sheets "Sheet1" to "Sheet3", in each new spreadsheet. You can switch between sheets in a spreadsheet using the sheet tabs at the bottom of the screen. + +Sheet Tabs + + + + + + + +Icon + + + + Use the navigation buttons to display all the sheets belonging to your document. Clicking the button on the far left or the far right displays, respectively, the first or last sheet tab. The middle buttons allow the user to scroll forward and backward through all sheet tabs. To display the sheet itself click on the sheet tab. + + +
+
+ + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/multioperation.xhp b/helpcontent2/source/text/scalc/guide/multioperation.xhp new file mode 100644 index 000000000..8a4a8e0e0 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/multioperation.xhp @@ -0,0 +1,124 @@ + + + + + + + + +Applying Multiple Operations +/text/scalc/guide/multioperation.xhp + + + +multiple operations +what if operations;two variables +tables; multiple operations in +data tables; multiple operations in +cross-classified tables +mw made "what if operations" a two level entry +

Applying Multiple Operations +

+

Multiple Operations in Columns or Rows

+The Data - Multiple Operations command provides a planning tool for "what if" questions. In your spreadsheet, you enter a formula to calculate a result from values that are stored in other cells. Then, you set up a cell range where you enter some fixed values, and the Multiple Operations command will calculate the results depending on the formula. +In the Formulas field, enter the cell reference to the formula that applies to the data range. In the Column input cell/Row input cell field, enter the cell reference to the corresponding cell that is part of the formula. This can be explained best by examples: +

Examples

+You produce toys which you sell for $10 each. Each toy costs $2 to make, in addition to which you have fixed costs of $10,000 per year. How much profit will you make in a year if you sell a particular number of toys? + +what-if sheet area +

Calculating With One Formula and One Variable

+ + +To calculate the profit, first enter any number as the quantity (items sold) - in this example 2000. The profit is found from the formula Profit=Quantity * (Selling price - Direct costs) - Fixed costs. Enter this formula in B5. + + +In column D enter given annual sales, one below the other; for example, 500 to 5000, in steps of 500. + + +Select the range D2:E11, and thus the values in column D and the empty cells alongside in column E. + + +Choose Data - Multiple operations. + + +With the cursor in the Formulas field, click cell B5. + + +Set the cursor in the Column input cell field and click cell B4. This means that B4, the quantity, is the variable in the formula, which is replaced by the selected column values. + + +Close the dialog with OK. You see the profits for the different quantities in column E. + + +

Calculating with Several Formulas Simultaneously

+ + +Delete column E. + + +Enter the following formula in C5: = B5 / B4. You are now calculating the annual profit per item sold. + + +Select the range D2:F11, thus three columns. + + +Choose Data - Multiple Operations. + + +With the cursor in the Formulas field, select cells B5 thru C5. + + +Set the cursor in the Column input cell field and click cell B4. + + +Close the dialog with OK. You will now see the profits in column E and the annual profit per item in column F. + + +

Multiple Operations Across Rows and Columns

+ +%PRODUCTNAME allows you to carry out joint multiple operations for columns and rows in so-called cross-tables. The formula cell has to refer to both the data range arranged in rows and the one arranged in columns. Select the range defined by both data ranges and call the multiple operation dialog. Enter the reference to the formula in the Formulas field. The Row input cell and the Column input cell fields are used to enter the reference to the corresponding cells of the formula. +

Calculating with Two Variables

+Consider columns A and B of the sample table above. You now want to vary not just the quantity produced annually, but also the selling price, and you are interested in the profit in each case. +Expand the table shown above. D2 thru D11 contain the numbers 500, 1000 and so on, up to 5000. In E1 through H1 enter the numbers 8, 10, 15 and 20. + + +Select the range D1:H11. + + +Choose Data - Multiple Operations. + + +With the cursor in the Formulas field, click cell B5. + + +Set the cursor in the Row input cell field and click cell B1. This means that B1, the selling price, is the horizontally entered variable (with the values 8, 10, 15 and 20). + + +Set the cursor in the Column input cell field and click in B4. This means that B4, the quantity, is the vertically entered variable. + + +Close the dialog with OK. You see the profits for the different selling prices in the range E2:H11. + + +
+Multiple operations + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/multitables.xhp b/helpcontent2/source/text/scalc/guide/multitables.xhp new file mode 100644 index 000000000..7061c99dc --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/multitables.xhp @@ -0,0 +1,73 @@ + + + + + + + + + Applying Multiple Sheets + /text/scalc/guide/multitables.xhp + + + +sheets; inserting + inserting; sheets + sheets; selecting multiple + appending sheets + selecting;multiple sheets + multiple sheets + calculating;multiple sheets +MW moved "sheets;simultaneous.." to edit_multitables.xhp, transferred 2 entries from there and added "calculating;" +Applying Multiple Sheets + + Inserting a Sheet + + + Choose Insert - Sheet to insert a new sheet or an existing sheet from another file. + + + +Sheet Events +Opens a dialog box where you can assign macros to sheet events. + +Tab Color + +Opens a window where you can assign a color to the sheet tab. + + +Click to select all sheets in the document. + +Click to deselect all sheets in the document, except the current sheet. + Selecting Multiple Sheets + The sheet tab of the current sheet is always visible in white in front of the other sheet tabs. The other sheet tabs are gray when they are not selected. By clicking other sheet tabs while pressing CommandCtrl you can select multiple sheets. + You can use Shift+Command +Ctrl+Page Up or Page Down to select multiple sheets using the keyboard. + Undoing a Selection + To undo the selection of a sheet, click its sheet tab again while pressing the CommandCtrl key. The sheet that is currently visible cannot be removed from the selection. + Calculating Across Multiple Sheets + You can refer to a range of sheets in a formula by specifying the first and last sheet of the range, for example, =SUM(Sheet1.A1:Sheet3.A1) sums up all A1 cells on Sheet1 through Sheet3. + + +
+ + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/note_insert.xhp b/helpcontent2/source/text/scalc/guide/note_insert.xhp new file mode 100644 index 000000000..ca75f649c --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/note_insert.xhp @@ -0,0 +1,66 @@ + + + + + + + + + Inserting and Editing Comments + /text/scalc/guide/note_insert.xhp + + + +comments; on cells + cells;comments + remarks on cells + formatting;comments on cells + viewing;comments on cells + displaying; comments +MW deleted double index "comments;on cells" and copied "displaying;comments" from shared/optionen/01060100.xhp +Inserting and Editing Comments + +You can assign a comment to each cell by choosing Insert - Comment. The comment is indicated by a small red square, the comment indicator, in the cell. + + +The comment is visible whenever the mouse pointer is over the cell. + + +When you select the cell, you can choose Show Comment from the context menu of the cell. Doing so keeps the comment visible until you deactivate the Show Comment command from the same context menu. + + +To edit a permanently visible comment, just click in it. If you delete the entire text of the comment, the comment itself is deleted. + + +Move or resize each comment as you like. + + +Format each comment by specifying background color, transparency, border style, and text alignment. Choose the commands from the context menu of the comment. + + +To show or hide the comment indicator, choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - View and mark or unmark the Comment indicator check box. + + +To display a help tip for a selected cell, use Data - Validity - Input Help. +
+Insert - Comment + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/numbers_text.xhp b/helpcontent2/source/text/scalc/guide/numbers_text.xhp new file mode 100644 index 000000000..e63054fb0 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/numbers_text.xhp @@ -0,0 +1,93 @@ + + + + + + + + Converting Text to Numbers + /text/scalc/guide/numbers_text.xhp + + + + + + formats; text as numbers + time format conversion + date formats;conversion + converting;text, into numbers + +

Converting Text to Numbers

+
+ Defaults settings in Calc converts text inside cells to the respective numeric values if an unambiguous conversion is possible. If no conversion is possible, Calc returns a #VALUE! error. + Only integer numbers including exponent are converted, and ISO 8601 dates and times in their extended formats with separators. Anything else, like fractional numbers with decimal separators or dates other than ISO 8601, is not converted, as the text string would be locale dependent. Leading and trailing blanks are ignored. + The following ISO 8601 formats are converted: + + + CCYY-MM-DD + + + CCYY-MM-DDThh:mm + + + CCYY-MM-DDThh:mm:ss + + + CCYY-MM-DDThh:mm:ss,s + + + CCYY-MM-DDThh:mm:ss.s + + + hh:mm + + + hh:mm:ss + + + hh:mm:ss,s + + + hh:mm:ss.s + + + The century code CC may not be omitted. Instead of the T date and time separator, exactly one space character may be used. + If a date is given, it must be a valid Gregorian calendar date. In this case the optional time must be in the range 00:00 to 23:59:59.99999... + If only a time string is given, it may have an hours value of more than 24, while minutes and seconds can have a maximum value of 59. + The conversion is done for single scalar values only, not within ranges. + The conversion is done for single scalar values, as in =A1+A2, or ="1E2"+1. Cell range arguments are not affected, so SUM(A1:A2) differs from A1+A2 if at least one of the two cells contain a convertible string. + Strings inside formulas are also converted, such as in ="1999-11-22"+42, which returns the date 42 days after November 22nd, 1999. Calculations involving localized dates as strings inside the formula return an error. For example, the localized date string "11/22/1999" or "22.11.1999" cannot be used for the automatic conversion. + +

Example

+ In A1 enter the text '1e2 (which is converted to the number 100 internally). + In A2 enter =A1+1 (which correctly results in 101). + The formula =SUM(A1:A2), returns 101 instead of 201 because the conversion does not occur in a range, only for single scalar values. Here, '1e2 is treated as string which is ignored for the SUM function. + =SUM("1E2";1) returns #VALUE! because SUM() and some others that iterate over number sequences explicitly check the argument type. +
+

Changing the default text to number conversion settings

+ The text to number conversion can be customized in the Detailed Calculation Settings option. +
+ + + + Format - Cells - Numbers + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/pivotchart.xhp b/helpcontent2/source/text/scalc/guide/pivotchart.xhp new file mode 100644 index 000000000..80dc442ad --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/pivotchart.xhp @@ -0,0 +1,40 @@ + + + + + + + Pivot Chart + /text/scalc/guide/pivotchart.xhp + + + + + chart;pivot chart + pivot table;pivot chart + +

Pivot Chart

+ + A pivot chart is a chart with data range and data series of a pivot table. + Different from static sized tables, where the number of rows and columns are constant, pivot tables can have varying dimensions, depending on the pivot table settings and its data source contents. + + Pivot charts track the changes in the data issued from a pivot table and adjust the data series and data range accordingly. + + +
+ + + + + + Technical details on %PRODUCTNAME pivot chart implementation. +
+ + diff --git a/helpcontent2/source/text/scalc/guide/pivotchart_create.xhp b/helpcontent2/source/text/scalc/guide/pivotchart_create.xhp new file mode 100644 index 000000000..a4ff84dcf --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/pivotchart_create.xhp @@ -0,0 +1,58 @@ + + + + + + + Creating Pivot Charts + /text/scalc/guide/pivotchart_create.xhp + + + + + pivot chart;creating + + Creating Pivot Charts + To create a pivot chart proceed as below: + + + Click inside the pivot table that you want to present in your chart. + + + Choose Insert – Chart or click in the + Insert Chart Icon Insert Chart icon in the main toolbar. + + + %PRODUCTNAME Calc automatically detects the pivot table and opens the pivot chart wizard. + + + Select the Chart type for the data in the chart wizard. + + + The data range and the data series pages of the chart wizard are not enabled. They are controlled by the pivot table. + + + Select the Chart Elements of the pivot chart in the wizard. + + + Click OK to close the wizard and create the pivot chart. + + + + +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/pivotchart_delete.xhp b/helpcontent2/source/text/scalc/guide/pivotchart_delete.xhp new file mode 100644 index 000000000..597730164 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/pivotchart_delete.xhp @@ -0,0 +1,36 @@ + + + + + + + Deleting Pivot Charts + /text/scalc/guide/pivotchart_delete.xhp + + + + Deleting a Pivot Chart + + pivot chart;deleting + + To delete a pivot chart, select the chart and press Del. + When deleting a pivot chart, the linked pivot table is not affected. + If you delete a pivot table linked to a pivot chart, the pivot chart is also deleted. A dialog box opens to confirm the pivot chart deletion. + + +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/pivotchart_edit.xhp b/helpcontent2/source/text/scalc/guide/pivotchart_edit.xhp new file mode 100644 index 000000000..428edacd3 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/pivotchart_edit.xhp @@ -0,0 +1,41 @@ + + + + + + + Editing Pivot Charts + /text/scalc/guide/pivotchart_edit.xhp + + + + + pivot chart;editing + + Editing Pivot Charts + Edit a pivot chart in the same way as normal charts. + To edit a pivot chart + + + + + + + + +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/pivotchart_filter.xhp b/helpcontent2/source/text/scalc/guide/pivotchart_filter.xhp new file mode 100644 index 000000000..11ccabb53 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/pivotchart_filter.xhp @@ -0,0 +1,44 @@ + + + + + + + Filtering Pivot Charts + /text/scalc/guide/pivotchart_filter.xhp + + + + Filtering Pivot Charts + Filters are used to remove unwanted data from the pivot chart. You can use filters in the pivot chart or in the corresponding pivot table, since the resulting chart is exactly the same. + + Pivot chart field buttons + + Pivot chart buttons are unique to pivot charts, normal charts don't have them. The buttons shows the layout of the pivot table, which are the pivot table fields. If present, filters are displayed in the top. Row fields are displayed on the bottom of the chart next to each other and the legend shows the buttons from column fields stacked. + + + Pivot chart buttons + + + The buttons have a pop-up action attached to them. If there is some filtering applied, then the arrow turns blue (similar to the pivot table), so it is easier to see when a field has any filter applied. + + Existing filters shows what is filtered: when nothing is filtered "- all -" is shown, when some data is filtered, then "- multiple -" is shown and when only one value is not filtered, the value is shown. + + + +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/pivotchart_update.xhp b/helpcontent2/source/text/scalc/guide/pivotchart_update.xhp new file mode 100644 index 000000000..41cfed9cb --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/pivotchart_update.xhp @@ -0,0 +1,42 @@ + + + + + + + Pivot Chart Update + /text/scalc/guide/pivotchart_update.xhp + + + + + pivot chart;update + + Updating Pivot Charts + If the data of the source sheet has been changed, you must refresh the pivot table and the pivot chart is updated accordingly. To refresh the pivot table (and thus the pivot chart): + + + Choose Data - Pivot Table - Refresh. + + + Choose Refresh... in the context menu of any cell in the pivot table. + + + + +
+ + + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/print_details.xhp b/helpcontent2/source/text/scalc/guide/print_details.xhp new file mode 100644 index 000000000..8b419dfc6 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/print_details.xhp @@ -0,0 +1,93 @@ + + + + + + + + +Printing Sheet Details +/text/scalc/guide/print_details.xhp + + +Sun Microsystems, Inc. + + + +printing;sheet details +sheets; printing details +grids; printing sheet grids +formulas; printing, instead of results +comments; printing +charts;printing +sheet grids; printing +cells; printing grids +borders; printing cells +zero values; printing +null values; printing +draw objects;printing +mw inserted 4 index entries from text/scalc/01/05070500.xhp. Added "draw objects;..." entry and changed "formulas;..." entry +Printing Sheet Details + +When printing a sheet you can select which details are to be printed: + + +Row and column headers + + +Sheet grid + + +Comments + + +Objects and images + + +Charts + + +Drawing objects + + +Formulas + + +To choose the details proceed as follows: + + +Select the sheet you want to print. + + +Choose Format - Page. +The command is not visible if the sheet was opened with write protection on. In that case, click the Edit File icon on the Standard Bar. + + +Select the Sheet tab. In the Print area mark the details to be printed and click OK. + + +Print the document. + + +
+View - Page Break + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/print_exact.xhp b/helpcontent2/source/text/scalc/guide/print_exact.xhp new file mode 100644 index 000000000..5e6715cd7 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/print_exact.xhp @@ -0,0 +1,63 @@ + + + + + + + + +Defining Number of Pages for Printing +/text/scalc/guide/print_exact.xhp + + +Sun Microsystems, Inc. + + + +printing; sheet counts +sheets; printing sheet counts +page breaks; spreadsheet preview +editing;print ranges +viewing;print ranges +previews;page breaks for printing + +Defining Number of Pages for Printing + +If a sheet is too large for a single printed page, $[officename] Calc will print the current sheet evenly divided over several pages. Since the automatic page break does not always take place in the optimal position, you can define the page distribution yourself. + + +Go to the sheet to be printed. + + +Choose View - Page Break. + + +You will see the automatic distribution of the sheet across the print pages. The automatically created print ranges are indicated by dark blue lines, and the user-defined ones by light blue lines. The page breaks (line breaks and column breaks) are marked as black lines. + + +You can move the blue lines with the mouse. You will find further options in the Context menu, including adding an additional print range, removing the scaling and inserting additional manual line and column breaks. + + +
+View - Page Break + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/print_landscape.xhp b/helpcontent2/source/text/scalc/guide/print_landscape.xhp new file mode 100644 index 000000000..542e2d9dc --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/print_landscape.xhp @@ -0,0 +1,79 @@ + + + + + + + + + Printing Sheets in Landscape Format + /text/scalc/guide/print_landscape.xhp + + + +printing; sheet selections + sheets; printing in landscape + printing; landscape + landscape printing +mw corrected a typo in "printing; sheet..." +Printing Sheets in Landscape Format + + In order to print a sheet you have a number of interactive options available under View - Page Break. Drag the delimiter lines to define the range of printed cells on each page. + To print in landscape format, proceed as follows: + + + Go to the sheet to be printed. + + + Choose Format - Page. + The command is not visible if the sheet has been opened with write protection on. In that case, click the Edit File icon on the Standard bar. + + + Select the Page tab. Select the Landscape paper format and click OK. + + + Choose File - Print. You will see the Print dialog. + Depending on the printer driver and the operating system, it may be necessary to click the Properties button and to change your printer to landscape format there. + + + In the Print dialog in the General tab page, select the contents to be printed: + + All sheets - All sheets will be printed. + + Selected sheets - Only the selected sheets will be printed. All sheets whose names (at the bottom on the sheet tabs) are selected will be printed. By pressing Command +Ctrl while clicking a sheet name you can change this selection. + + Selected cells - All selected cells are printed. + + + From all the paper pages that result from the above selection, you can select the range of paper pages to be printed: + + All pages - Print all resulting pages. + + Pages - Enter the pages to be printed. The pages will also be numbered from the first sheet onwards. If you see in the Page Break Preview that Sheet1 will be printed on 4 pages and you want to print the first two pages of Sheet2, enter 5-6 here. + + + If under Format - Print ranges you have defined one or more print ranges, only the contents of these print ranges will be printed. +
+ View - Page Break + Defining Print Ranges on a Sheet + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/print_title_row.xhp b/helpcontent2/source/text/scalc/guide/print_title_row.xhp new file mode 100644 index 000000000..d399b383c --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/print_title_row.xhp @@ -0,0 +1,82 @@ + + + + + +Printing Rows or Columns on Every Page +/text/scalc/guide/print_title_row.xhp + + +Sun Microsystems, Inc. + + + +printing; sheets on multiple pages +sheets; printing on multiple pages +rows; repeating when printing +columns; repeating when printing +repeating;columns/rows on printed pages +title rows; printing on all sheets +headers; printing on sheets +footers; printing on sheets +printing; rows/columns as table headings +headings;repeating rows/columns as +mw deleted one index entry ("fixed...") and added "headings;..." entry + +

Printing Rows or Columns on Every Page +

+If you have a sheet that is so large that it will be printed multiple pages, you can set up rows or columns to repeat on each printed page. +As an example, If you want to print the top two rows of the sheet as well as the first column (A) on all pages, do the following: + + +Choose Format - Print Ranges - Edit. The Edit Print Ranges dialog appears. + + +Click the icon at the far right of the Rows to repeat area. +The dialog shrinks so that you can see more of the sheet. + + +Select the first two rows and, for this example, click cell A1 and drag to A2. +In the shrunk dialog you will see $1:$2. Rows 1 and 2 are now rows to repeat. + + +Click the icon at the far right of the Rows to repeat area. The dialog is restored again. + + +If you also want column A as a column to repeat, click the icon at the far right of the Columns to repeat area. + + +Click column A (not in the column header). + + +Click the icon again at the far right of the Columns to repeat area. + + +Rows to repeat are rows from the sheet. You can define headers and footers to be printed on each print page independently of this in Format - Page. +
+ + + +View - Page Break Preview + +Format - Print ranges - Edit +Format - Page - (Header / Footer) +
+ + diff --git a/helpcontent2/source/text/scalc/guide/printranges.xhp b/helpcontent2/source/text/scalc/guide/printranges.xhp new file mode 100644 index 000000000..54211ba36 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/printranges.xhp @@ -0,0 +1,105 @@ + + + + + + + + + + +Using Print Ranges on a Spreadsheet +/text/scalc/guide/printranges.xhp + + + + + + +exporting;cells +printing; cells +ranges;print ranges +PDF export of print ranges +cell ranges; printing +cells; print ranges +print ranges +clearing, see also deleting/removing +defining;print ranges +extending print ranges +deleting;print ranges + + mw deleted "adding;" and corrected two typos in "defining;" and "extending.." + MW changed "clearing," + Defining Print Ranges on a Sheet + + You can define which range of cells on a spreadsheet to print. + The cells on the sheet that are not part of the defined print range are not printed or exported. Sheets without a defined print range are not printed and not exported to a PDF file, unless the document uses the Excel file format. + For files opened in Excel format, all sheets that do not contain a defined print range are printed. The same behavior occurs when you export the Excel formatted spreadsheet to a PDF file.UFI: New, see spec "Calc Print Settings Sheet Property "Print Entire Sheet"" + To Define a Print Range + + + Select the cells that you want to print. + + + Choose Format - Print Ranges - Define. + + + To Add Cells to a Print Range + + + Select the cells that you want to add to the existing print range. + + + Choose Format - Print Ranges - Add. + + + To Clear a Print Range + + + Choose Format - Print Ranges - Clear. + + + Using the Page Break Preview to Edit Print Ranges + In the Page Break Preview, print ranges as well as page break regions are outlined by a blue border and contain a centered page number in gray. Nonprinting areas have a gray background. + To define a new page break region, drag the border to a new location. When you define a new page break region, an automatic page break is replaced by a manual page break. + To View and Edit Print Ranges + + + Choose View - Page Break Preview. + To change the default zoom factor of the Page Break Preview, double click the percentage value on the Status bar, and select a new zoom factor. + + + Edit the print range. + To change the size of a print range, drag a border of the range to a new location. + To delete a manual page break that is contained in a print range, drag the border of the page break outside of the print range. + To clear a print range, drag a border of the range onto the opposite border of the range. + + + To exit the Page Break Preview, choose View - Normal. + + +
+ + + + Editing Print Ranges + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/relativ_absolut_ref.xhp b/helpcontent2/source/text/scalc/guide/relativ_absolut_ref.xhp new file mode 100644 index 000000000..35d15b6a5 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/relativ_absolut_ref.xhp @@ -0,0 +1,60 @@ + + + + + + + + +Addresses and References, Absolute and Relative +/text/scalc/guide/relativ_absolut_ref.xhp + + +Sun Microsystems, Inc. + + + +addressing; relative and absolute +references; absolute/relative +absolute addresses in spreadsheets +relative addresses +absolute references in spreadsheets +relative references +references; to cells +cells; references + +Addresses and References, Absolute and Relative + +Relative Addressing +The cell in column A, row 1 is addressed as A1. You can address a range of adjacent cells by first entering the coordinates of the upper left cell of the area, then a colon followed by the coordinates of the lower right cell. For example, the square formed by the first four cells in the upper left corner is addressed as A1:B2. +By addressing an area in this way, you are making a relative reference to A1:B2. Relative here means that the reference to this area will be adjusted automatically when you copy the formulas. +Absolute Addressing +Absolute referencing is the opposite of relative addressing. A dollar sign is placed before each letter and number in an absolute reference, for example, $A$1:$B$2. +$[officename] can convert the current reference, in which the cursor is positioned in the input line, from relative to absolute and vice versa by pressing F4. If you start with a relative address such as A1, the first time you press this key combination, both row and column are set to absolute references ($A$1). The second time, only the row (A$1), and the third time, only the column ($A1). If you press the key combination once more, both column and row references are switched back to relative (A1) +$[officename] Calc shows the references to a formula. If, for example, you click the formula =SUM(A1:C5;D15:D24) in a cell, the two referenced areas in the sheet will be highlighted in color. For example, the formula component "A1:C5" may be in blue and the cell range in question bordered in the same shade of blue. The next formula component "D15:D24" can be marked in red in the same way. +When to Use Relative and Absolute References +What distinguishes a relative reference? Assume you want to calculate in cell E1 the sum of the cells in range A1:B2. The formula to enter into E1 would be: =SUM(A1:B2). If you later decide to insert a new column in front of column A, the elements you want to add would then be in B1:C2 and the formula would be in F1, not in E1. After inserting the new column, you would therefore have to check and correct all formulas in the sheet, and possibly in other sheets. +Fortunately, $[officename] does this work for you. After having inserted a new column A, the formula =SUM(A1:B2) will be automatically updated to =SUM(B1:C2). Row numbers will also be automatically adjusted when a new row 1 is inserted. Absolute and relative references are always adjusted in $[officename] Calc whenever the referenced area is moved. But be careful if you are copying a formula since in that case only the relative references will be adjusted, not the absolute references. +Absolute references are used when a calculation refers to one specific cell in your sheet. If a formula that refers to exactly this cell is copied relatively to a cell below the original cell, the reference will also be moved down if you did not define the cell coordinates as absolute. +Aside from when new rows and columns are inserted, references can also change when an existing formula referring to particular cells is copied to another area of the sheet. Assume you entered the formula =SUM(A1:A9) in row 10. If you want to calculate the sum for the adjacent column to the right, simply copy this formula to the cell to the right. The copy of the formula in column B will be automatically adjusted to =SUM(B1:B9). +
+mw changed link target from "address_byname" to "value_with_name" +
+ + diff --git a/helpcontent2/source/text/scalc/guide/remove_duplicates.xhp b/helpcontent2/source/text/scalc/guide/remove_duplicates.xhp new file mode 100644 index 000000000..812f26153 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/remove_duplicates.xhp @@ -0,0 +1,68 @@ + + + + + + + Removing Duplicate Values + /text/scalc/guide/remove_duplicates.xhp + + + + + + filters; removing duplicates + filters; finding unique values + +

Removing Duplicate Values

+ Consider a single column with values where some may be duplicates. To remove duplicate values and obtain only the unique entries in the column: + + + Select the range of values from which duplicate values are to be removed. The values have to be arranged in a single column. + + + Go to Data - More Filters - Standard Filter. This opens the Standard Filter dialog. + + + In Field Name make sure that the selected column is the column where the values are stored. If a single column is selected this field will be set automatically. + + + In Condition choose the option = (equals sign), which is the default option. + + + In Value choose the option Not Empty. + + + Click Options and select No duplications. If the first value is the column header check Range contains column labels. + + + Check Copy results and use the input box below it to inform a cell address where the unique entries are to be entered. + + + Click OK. The unique values in the range will be entered starting with the cell selected in the previous step. + + + The No duplications option is case sensitive. Therefore, values "A" and "a" are each considered as unique values. +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/rename_table.xhp b/helpcontent2/source/text/scalc/guide/rename_table.xhp new file mode 100644 index 000000000..dd03da71e --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/rename_table.xhp @@ -0,0 +1,91 @@ + + + + + + + Renaming Sheets + /text/scalc/guide/rename_table.xhp + + + +renaming;sheets + sheet tabs;renaming + tables;renaming + names; sheets + +

Renaming Sheets +

+Setting sheet names is an important feature to produce readable and understandable spreadsheets documents. +The name of a sheet is independent of the name of the spreadsheet. You enter the spreadsheet name when you save it for the first time as a file. +To rename a sheet in your document: + + + Double-click the sheet tab or open its context menu and choose Rename Sheet. A dialog box appears where you can enter a new name. + + + Enter a new name for the sheet and click OK. + + + Alternatively, hold down the Option key +Alt key and click on any sheet name and enter the new name directly. + + +The document can contain up to 10,000 individual sheets, which must have different names. +

Sheet Naming Restrictions

+ Sheet names can contain almost any character. Some naming restrictions apply, the following characters are not allowed in sheet names: + + + colon : + + + back slash \ + + + forward slash / + + + question mark ? + + + asterisk * + + + left square bracket [ + + + right square bracket ] + + + single quote ' as the first or last character of the name + + +The single quote is Unicode U+0027, also known as apostrophe. Other single-quote characters, similar to apostrophe, are allowed, such as ʼ ‛ and ‚. +

Using a Default Prefix for Sheet Names

+ You can set a prefix for the names of new sheets you create. Choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Defaults and enter the prefix name in Prefix name for new worksheet. +

Referencing Sheet Names with Special Characters

+ In cell references, a sheet name must be enclosed in single quotes ' when the name contains other characters than alphanumeric or underscore. A single quote contained within a name has to be escaped by doubling it (two single quotes). + For example, you want to reference the cell A1 on a sheet named This year's sheet. + + The reference must be enclosed in single quotes, and the one single quote inside the name must be doubled: 'This year''s sheet'.A1 +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/rounding_numbers.xhp b/helpcontent2/source/text/scalc/guide/rounding_numbers.xhp new file mode 100644 index 000000000..b9ebc4ac7 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/rounding_numbers.xhp @@ -0,0 +1,84 @@ + + + + + + + + +Using Rounded Off Numbers +/text/scalc/guide/rounding_numbers.xhp + + +Sun Microsystems, Inc. + + + +numbers; rounded off +rounded off numbers +exact numbers in $[officename] Calc +decimal places; showing +changing;number of decimal places +values;rounded in calculations +calculating;rounded off values +numbers; decimal places +precision as shown +rounding precision +spreadsheets; values as shown +mw reduced "tables in spreadsheets;" to "tables;" + +Using Rounded Off Numbers + +In $[officename] Calc, all decimal numbers are displayed rounded off to two decimal places. +To change this for selected cells + + +Mark all the cells you want to modify. + + +Choose Format - Cells and go to the Numbers tab page. + + +In the Category field, select Number. Under Options, change the number of Decimal places and exit the dialog with OK. + + +To change this everywhere + + +Choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc. + + +Go to the Calculate page. Modify the number of Decimal places and exit the dialog with OK. + + +To calculate with the rounded off numbers instead of the internal exact values + + +Choose %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc. + + +Go to the Calculate page. Mark the Precision as shown field and exit the dialog with OK. + + +
+Numbers +Calculate +
+ + diff --git a/helpcontent2/source/text/scalc/guide/row_height.xhp b/helpcontent2/source/text/scalc/guide/row_height.xhp new file mode 100644 index 000000000..0275f52dc --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/row_height.xhp @@ -0,0 +1,73 @@ + + + + + + + + +Changing Row Height or Column Width +/text/scalc/guide/row_height.xhp + + +Sun Microsystems, Inc. + + + +heights of cells +cell heights +cell widths +cells; heights and widths +widths of cells +column widths +rows; heights +columns; widths +changing;row heights/column widths + +Changing Row Height or Column Width + +You can change the height of the rows with the mouse or through the dialog. +What is described here for rows and row height applies accordingly for columns and column width. +Using the mouse to change the row height or column width + + +Click the area of the headers on the separator below the current row, keep the mouse button pressed and drag up or down in order to change the row height. + + +Select the optimal row height by double-clicking the separator below the row. + + +Using the dialog to change the row height or column width + + +Click the row so that you achieve the focus. + + +Start the context menu on the header at the left-hand side. +You will see the commands Row Height and Optimal row height. Choosing either opens a dialog. + + +
+Row height +Optimal row height +Column width +Optimal column width +
+ + diff --git a/helpcontent2/source/text/scalc/guide/scenario.xhp b/helpcontent2/source/text/scalc/guide/scenario.xhp new file mode 100644 index 000000000..a6cdd2979 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/scenario.xhp @@ -0,0 +1,85 @@ + + + + + + + + + + +Using Scenarios +/text/scalc/guide/scenario.xhp + + + +scenarios; creating/editing/deleting +opening;scenarios +selecting;scenarios in Navigator +UFI: removed "sample" from index term: no sample in OOoMW changed "scenarios;"Using Scenarios + +A $[officename] Calc scenario is a set of cell values that can be used within your calculations. You assign a name to every scenario on your sheet. Define several scenarios on the same sheet, each with some different values in the cells. Then you can easily switch the sets of cell values by their name and immediately observe the results. Scenarios are a tool to test out "what-if" questions. +Creating Your Own Scenarios +To create a scenario, select all the cells that provide the data for the scenario. + + +Select the cells that contain the values that will change between scenarios. To select multiple cells, hold down the CommandCtrl key as you click each cell. + + +Choose Tools - Scenarios. The Create Scenario dialog appears. + + +Enter a name for the new scenario and leave the other fields unchanged with their default values. Close the dialog with OK. Your new scenario is automatically activated. + + +Using Scenariosremoved "commercial" switched contentsScenarios can be selected in the Navigator: + + +Open the Navigator with the Navigator icon +Navigator icon + on the Standard bar. + + +Click the Scenarios icon +Scenarios icon + in the Navigator. + + +In the Navigator, you see the defined scenarios with the comments that were entered when the scenarios were created. + + +Double-click a scenario name in the Navigator to apply that scenario to the current sheet. + + +To delete a scenario, right-click the name in the Navigator and choose Delete. + + +To edit a scenario, right-click the name in the Navigator and choose Properties. + + +To hide the border of a set of cells that are part of a scenario, open the Properties dialog for each scenario that affects the cells and clear the Display border checkbox. Hiding the border also removes the listbox on the sheet where you can choose the scenarios. + + +If you want to know which values in the scenario affect other values, choose Tools - Detective - Trace Dependents. You see arrows to the cells that are directly dependent on the current cell. +
+Creating Scenarios + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/sorted_list.xhp b/helpcontent2/source/text/scalc/guide/sorted_list.xhp new file mode 100644 index 000000000..26a27df95 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/sorted_list.xhp @@ -0,0 +1,58 @@ + + + + + + + + + + +Applying Sort Lists +/text/scalc/guide/sorted_list.xhp + + + + + + +filling;customized lists +sort lists;applying +defining;sort lists +geometric lists +arithmetic lists +series;sort lists +lists; user-defined +customized lists + + mw deleted "applying;" + Applying Sort Lists + + Sort lists allow you to type one piece of information in a cell, then drag it to fill in a consecutive list of items. + For example, enter the text "Jan" or "January" in an empty cell. Select the cell and click the mouse on the lower right corner of the cell border. Then drag the selected cell a few cells to the right or downwards. When you release the mouse button, the highlighted cells will be filled with the names of the months. + Hold down CommandCtrl if you do not want to fill the cells with different values. + The predefined series can be found under %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc - Sort Lists. You can also create your own lists of text strings tailored to your needs, such as a list of your company's branch offices. When you use the information in these lists later (for example, as headings), just enter the first name in the list and expand the entry by dragging it with your mouse. +
+ + + Sort lists + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/specialfilter.xhp b/helpcontent2/source/text/scalc/guide/specialfilter.xhp new file mode 100644 index 000000000..e20621436 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/specialfilter.xhp @@ -0,0 +1,223 @@ + + + + + + + + Applying Advanced Filters + /text/scalc/guide/specialfilter.xhp + + + + +filters;defining advanced filters +advanced filters +defining; advanced filters +database ranges; advanced filters + +MW made "applying;advanced filters" a one level entry +
+

Applying Advanced Filters +

+ + + Copy the column headers of the sheet ranges to be filtered into an empty area of the sheet, and then enter the criteria for the filter in a row beneath the headers. Horizontally arranged data in a row will always be logically connected with AND, and vertically arranged data in a column will always be logically connected with OR. + + + Once you have created a filter matrix, select the sheet ranges to be filtered. Open the Advanced Filter dialog by choosing Data - More Filters - Advanced Filter, and define the filter conditions. + + + Then click OK, and you will see that only the rows from the original sheet whose contents have met the search criteria are still visible. All other rows are temporarily hidden and can be made to reappear with the Format - Rows - Show command. + + +

Example

+ Load a spreadsheet with a large number of records. We are using a fictional Turnover document, but you can just as easily use any other document. The document has the following layout: + + + + + A + + + B + + + C + + + D + + + E + + + + + 1 + + + Month + + + Standard + + + Business + + + Luxury + + + Suite + + + + + 2 + + + January + + + 125600 + + + 200500 + + + 240000 + + + 170000 + + + + + 3 + + + February + + + 160000 + + + 180300 + + + 362000 + + + 220000 + + + + + 4 + + + March + + + 170000 + + + + + and so on... + + +
+ Copy row 1 with the row headers (field names), to row 20, for example. Enter the filter conditions linked with OR in rows 21, 22, and so on. + + + + + A + + + B + + + C + + + D + + + E + + + + + 20 + + + Month + + + Standard + + + Business + + + Luxury + + + Suite + + + + + 21 + + + January + + + + + + + + + 22 + + + + <160000 + + + + + +
+ Specify that only rows which either have the value January in the Month cells OR a value of under 160000 in the Standardstandard not default, look at U59!!! cells will be displayed. + Choose Data - More Filters - Advanced Filter, and then select the range A20:E22. After you click OK, only the filtered rows will be displayed. The other rows will be hidden from view. +
+ +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/subtotaltool.xhp b/helpcontent2/source/text/scalc/guide/subtotaltool.xhp new file mode 100644 index 000000000..3ec316002 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/subtotaltool.xhp @@ -0,0 +1,66 @@ + + + + + + + Using Subtotals Tool + /text/scalc/guide/subtotaltool.xhp + + + + + subtotals;using subtotals tool + +
+

Using Subtotal Tool

+ Calc offers the Subtotals tool as a more comprehensive alternative to the SUBTOTAL function. In contrast to SUBTOTAL, which only works on a single array, the Subtotals tool can create subtotals for up to three arrays arranged in labeled columns. It also groups subtotals by category and sorts them automatically, thereby eliminating the need to apply AutoFilters and filter categories by hand. +
+
+ +
+

Using the Subtotals tool

+To insert subtotal values into a worksheet: + + + Select the cell range for the subtotals that you want to calculate, and remember to include the column heading labels. Alternatively, click on a single cell within your data to allow Calc to automatically identify the range. + + + Choose Data - Subtotals to open the Subtotals dialog. + + + In the Group by drop-down list on the First Group page, select a column by its label. Entries in the cell range from step 1 will be grouped and sorted by matching values in this column. + + + In the Calculate subtotals for box on the First Group page, select a column containing values to be subtotaled. If you later change values in this column, Calc will automatically recalculate the subtotals. + + + In the Use function box on the First Group page, select a function to calculate the subtotals for the column selected in step 4. + + + Repeat steps 4 and 5 to create subtotals for other columns on the First Group page. + + + You can create two more subtotal categories by using the Second Group and Third Group pages and repeating steps 3 to 6. If you do not want to add more groups, then leave the Group by list for each page set to “- none -”. + + + Click OK. Calc will add subtotal and grand total rows to your cell range. + + +

Subtotal outline

+ +When you use the Subtotals tool, Calc inserts an outline to the left of the row number column. This outline represents the hierarchical structure of your subtotals, and can be used to hide or show data at different levels in the hierarchy using the numbered column indicators at the top of the outline or the group indicators, denoted by plus (+) and minus (-) signs. +This feature is useful if you have many subtotals, as you can simply hide low-level details, such as individual entries, to produce a high-level summary of your data. +To turn off outlines, choose Data - Group and Outline - Remove Outline. To reinstate them, choose Data - Group and Outline - AutoOutline. +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/super_subscript.xhp b/helpcontent2/source/text/scalc/guide/super_subscript.xhp new file mode 100644 index 000000000..d70047639 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/super_subscript.xhp @@ -0,0 +1,60 @@ + + + + + + + + +Text Superscript / Subscript +/text/scalc/guide/super_subscript.xhp + + +Sun Microsystems, Inc. + + + +superscript text in cells +subscript text in cells +cells; text super/sub +characters;superscript/subscript + +Text Superscript / Subscript + + + +In the cell, select the character that you want to put in superscript or subscript. +If, for example, you want to write H20 with a subscript 2, select the 2 in the cell (not in the input line). + + +Open the context menu for the selected character and choose Character. You will see the Character dialog. + + +Click the Font Position tab. + + +Select the Subscript option and click OK. + + +
+Context menu - Character - Font Position + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/table_cellmerge.xhp b/helpcontent2/source/text/scalc/guide/table_cellmerge.xhp new file mode 100644 index 000000000..fe16ebb63 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/table_cellmerge.xhp @@ -0,0 +1,70 @@ + + + + + + + Merge and Unmerge Cells + /text/scalc/guide/table_cellmerge.xhp + + + + + merge/merging cells + unmerge/unmerging cells + split/splitting cells + +
+ Merge and Unmerge Cells + You can select a range of cells, then merge them into a single cell. Conversely, you can take a previously merged cell and divide it back into individual cells. +
+ When you copy cells into a target range containing merged cells, the target range gets unmerged first, then the copied cells are pasted in. If the copied cells are merged cells, they retain their merge state. + Merge Cells + + +
+ Click and drag to select the cells to be merged then do one of the following: + In the Formatting toolbar click: + + Or, right click the selection to open the context menu and choose Merge Cells.
If Unmerge Cells is present instead then the cell selection contains merged cells and cannot be merged further. + Or, in the Properties sidebar mark the Merge Cells checkbox. + Or, choose Format - Merge and Unmerge Cells - Merge Cells + Or, choose Format - Merge and Unmerge Cells - Merge and Center Cells + The cells will be merged and the content will be centered in the merged cell. +
+ + Unmerge Cells +
+ Select the cell to be unmerged, or a selection that includes the cells to be unmerged then do one of the following: + In the Formatting toolbar, click: + + Or, right click the selection to open the context menu and choose Unmerge Cells.
If Merge Cells is present instead then the selection does not contain any merged cells. + Or, in the Properties sidebar clear the Merge Cells checkbox. + Or, choose Format - Merge and Unmerge Cells - Unmerge Cells. + Or, toggle Format - Merge and Unmerge Cells - Merge and Center Cells +
+ +
+ + + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/table_rotate.xhp b/helpcontent2/source/text/scalc/guide/table_rotate.xhp new file mode 100644 index 000000000..2593105f7 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/table_rotate.xhp @@ -0,0 +1,67 @@ + + + + + + + + +Rotating Tables (Transposing) +/text/scalc/guide/table_rotate.xhp + + +Sun Microsystems, Inc. + + + +tables; transposing +transposing tables +inverting tables +swapping tables +columns; swap with rows +rows; swapping with columns +tables; rotating +rotating; tables + +Rotating Tables (Transposing) + +In $[officename] Calc, there is a way to "rotate" a spreadsheet so that rows become columns and columns become rows. + + +Select the cell range that you want to transpose. + + +Choose Edit - Cut. + + +Click the cell that is to be the top left cell in the result. + + +Choose Edit - Paste Special. + + +In the dialog, mark Paste all and Transpose. +If you now click OK the columns and rows are transposed. + + +
+Paste Special +
+ + diff --git a/helpcontent2/source/text/scalc/guide/table_view.xhp b/helpcontent2/source/text/scalc/guide/table_view.xhp new file mode 100644 index 000000000..b36cee5f5 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/table_view.xhp @@ -0,0 +1,59 @@ + + + + + + + + +Changing Table Views +/text/scalc/guide/table_view.xhp + + +Sun Microsystems, Inc. + + + +row headers; hiding +column headers; hiding +tables; views +views; tables +grids;hiding lines in sheets +hiding;headers/grid lines +changing;table views + +Changing Table Views + +To hide column and line headers in a table: + + +Under the menu item %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc, go to the View tab page. Unmark Column/row headers. Confirm with OK. + + +To hide grid lines: + + +Under the menu item %PRODUCTNAME - PreferencesTools - Options - %PRODUCTNAME Calc, go to the View tab page. Choose Hide in the Grid lines dropdown. Confirm with OK. + + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/text_numbers.xhp b/helpcontent2/source/text/scalc/guide/text_numbers.xhp new file mode 100644 index 000000000..139ae3469 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/text_numbers.xhp @@ -0,0 +1,50 @@ + + + + + + + + + Formatting Numbers as Text + /text/scalc/guide/text_numbers.xhp + + + +numbers;entering as text + text formats; for numbers + formats; numbers as text + cell formats; text/numbers + formatting;numbers as text +mw deleted "numbers; entering without..." and changed "numbers;as text" +Formatting Numbers as Text + +
+ You can format numbers as text in $[officename] Calc. Open the context menu of a cell or range of cells and choose Format Cells - Numbers, then select "Text" from the Category list. Any numbers subsequently entered into the formatted range are interpreted as text. The display of these "numbers" is left-justified, just as with other text. + If you have already entered normal numbers in cells and have afterwards changed the format of the cells to "Text", the numbers will remain normal numbers. They will not be converted. Only numbers entered afterwards, or numbers which are then edited, will become text numbers. + If you decide to enter a number directly as text, enter an apostrophe (') first. For example, for years in column headings, you can enter '1999, '2000 and '2001. The apostrophe is not visible in the cell, it only indicates that the entry is to be recognized as a text. This is useful if, for example, you enter a telephone number or postal code that begins with a zero (0), because a zero (0) at the start of a sequence of digits is removed in normal number formats. +
+
+ + + Format - Cells - Numbers + +
+ + \ No newline at end of file diff --git a/helpcontent2/source/text/scalc/guide/text_rotate.xhp b/helpcontent2/source/text/scalc/guide/text_rotate.xhp new file mode 100644 index 000000000..2c8b1bbaa --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/text_rotate.xhp @@ -0,0 +1,55 @@ + + + + + + + + + Rotating Text + /text/scalc/guide/text_rotate.xhp + + + +cells; rotating text + rotating; text in cells + text in cells; writing vertically + +Rotating Text + + + + Select the cells whose text you want to rotate. + + + Choose Format - Cells. You will see the Format Cells dialog. + + + Click the Alignment tab. + + + In the Text orientation area use the mouse to select in the preview wheel the direction in which the text is to be rotated. Click OK. + + removed a wrong para, i104207 +
+ Format - Cells + Format - Cells - Alignment +
+ + diff --git a/helpcontent2/source/text/scalc/guide/text_wrap.xhp b/helpcontent2/source/text/scalc/guide/text_wrap.xhp new file mode 100644 index 000000000..2bc0603e7 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/text_wrap.xhp @@ -0,0 +1,56 @@ + + + + + + + + +Writing Multi-line Text +/text/scalc/guide/text_wrap.xhp + + + +text in cells; multi-line +cells; text breaks +breaks in cells +multi-line text in cells + +

Writing Multi-line Text +

+
+Pressing the CommandCtrl+Enter keys inserts a manual line break. This shortcut works directly in the cell or in the input line. The input line can be expanded to the multi-line by the Down arrow button on the right. +If you want the text to automatically break at the right border of the cell, proceed as follows: + + +Select all the cells where you want the text to break at the right border. + + + In Format - Cells - Alignment, mark the Wrap text automatically option and click OK. + + +
+For automatic wrapping in XLS files, the rows in question should be set to Optimal Height. +
+
+
+Format - Cells +
+ + diff --git a/helpcontent2/source/text/scalc/guide/userdefined_function.xhp b/helpcontent2/source/text/scalc/guide/userdefined_function.xhp new file mode 100644 index 000000000..80d4f2525 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/userdefined_function.xhp @@ -0,0 +1,120 @@ + + + + + + +User-Defined Functions +/text/scalc/guide/userdefined_function.xhp + + +Sun Microsystems, Inc. + + + +functions; user-defined +user-defined functions +Basic IDE for user-defined functions +IDE; Basic IDE +programming;functions + +

User-Defined Functions +

+You can apply user-defined functions in $[officename] Calc in the following ways: + + +You can define your own functions using the Basic-IDE. This method requires a basic knowledge of programming. + + +You can program functions as add-ins. This method requires an advanced knowledge of programming. + + +

Defining A Function Using %PRODUCTNAME Basic

+ + + Choose Tools - Macros - Edit Macros. + + +You will now see the Basic IDE. + + +In the Object Catalog window, double-click on the module where you want to store your macro. + + +Enter the function code. In this example, we define a VOL(a; b; c) function that calculates the volume of a rectangular solid with side lengths a, b and c: + + + + Function VOL(a, b, c) + VOL = a*b*c + End Function + + + +Close the Basic-IDE window. +Your function is automatically saved in the selected module and is now available. If you apply the function in a Calc document that is to be used on another computer, you can copy the function to the Calc document as described in the next section. + + +

Copying a Function To a Document

+In stage 2 of "Defining A Function Using %PRODUCTNAME Basic", in the Macro dialog you clicked on Edit . As the default, in the Macro from field the My Macros - Standard - Module1 module is selected. The Standard library resides locally in your user directory. +If you want to copy the user-defined function to a Calc document: + + + Choose Tools - Macros - Organize Macros - Basic. + + +In the Macro from field select My Macros - Standard - Module1 and click Edit. + + +In the Basic-IDE, select the source of your user-defined function and copy it to the clipboard. + + +Close the Basic-IDE. + + +Choose Tools - Macros - Organize Macros - Basic . + + +In the Macro from field select (Name of the Calc document) - Standard - Module1. Click Edit. + + +Paste the clipboard contents in the Basic-IDE of the document. + + +

Applying a User-defined Function in $[officename] Calc

+Once you have defined the function VOL(a; b; c) in the Basic-IDE, you can apply it the same way as the built-in functions of $[officename] Calc. + + +Open a Calc document and enter numbers for the function parameters a, b and c in cells A1, B1, and C1. + + +Set the cursor in another cell and enter the following: +=VOL(A1;B1;C1) + + +The function is evaluated and you will see the result in the selected cell. + + +
+ + + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/validity.xhp b/helpcontent2/source/text/scalc/guide/validity.xhp new file mode 100644 index 000000000..76d5eb8ec --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/validity.xhp @@ -0,0 +1,93 @@ + + + + + + + + + +Validity of Cell Contents +/text/scalc/guide/validity.xhp + + +Sun Microsystems, Inc. + + + +values; limiting on input +limits; specifying value limits on input +permitted cell contents +data validity +validity +cells; validity +error messages; defining for incorrect input +actions in case of incorrect input +Help tips; defining text for cell input +comments;help text for cells +cells; defining input help +macros; running when incorrect input +data; validity check +mw changed "limit...;" +Validity of Cell Contents + +For each cell, you can define entries to be valid. Invalid entries to a cell will be rejected. +The validity rule is activated when a new value is entered. If an invalid value has already been inserted into the cell, or if you insert a value in the cell either with drag-and-drop or by copying and pasting, the validity rule will not take effect. +You can choose Tools - Detective at any time and choose the command Mark Invalid Data to display which cells contain invalid values. +Using Cell Contents Validity + + +Select the cells for which you want to define a new validity rule. + + +Choose Data - Validity. + + +On the Criteria tab page, enter the conditions for new values entered into cells. + + +In the Allow field, select an option. + + +If you select "Whole Numbers", values such as "12.5" are not allowed. Choosing "Date" allows date information both in the local date format as well as in the form of a serial date. Similarly, the "Time" condition permits time values such as "12:00" or serial time numbers. "Text Length" stipulates that cells are allowed to contain text only. +Select "List" to enter a list of valid entries. + + +Select the next condition under Data. According to what you choose, additional options will be selectable. + + +After you have determined the conditions for cell validity, you can use the other two tab pages to create message boxes: + + +On the Input Help tab page, enter the title and the text of the tip, which will then be displayed if the cell is selected. + + +On the Error Alert tab page, select the action to be carried out in the event of an error. +If you select "Stop" as the action, invalid entries are not accepted, and the previous cell contents are retained. +Select "Warning" or "Information" to display a dialog in which the entry can either be canceled or accepted. +If you select "Macro", then by using the Browse button you can specify a macro to be run in the event of an error. + + +To display the error message, select Show error message when invalid values are entered. +After changing the action for a cell on the Error Alert tab page and closing the dialog with OK, you must first select another cell before the change takes effect. +
+Data - Validity +
+ + diff --git a/helpcontent2/source/text/scalc/guide/value_with_name.xhp b/helpcontent2/source/text/scalc/guide/value_with_name.xhp new file mode 100644 index 000000000..5a82195f7 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/value_with_name.xhp @@ -0,0 +1,92 @@ + + + + + + + + + Naming Cells + /text/scalc/guide/value_with_name.xhp + + + +cells; defining names + names; defining for cells + values; defining names + constants definition + variables; defining names + cell ranges; defining names + defining;names for cell ranges + formulas; defining names + addressing; by defined names + cell names; defining/addressing + references; by defined names + allowed cell names + renaming;cells +mw changed "names;...", "addressing;..." and "references,..." entries.mw added "renaming;" +Naming Cells + + Allowed names + Names in Calc can contain letters, numeric characters, and some special characters. Names must start with a letter or an underline character. + Allowed special characters: + + + underline (_) + + + period (.) - allowed within a name, but not as first or last character + + + blank ( ) - allowed within a name, but not as first or last character, and not for a cell range + + + Names must not be the same as cell references. For example, the name A1 is invalid because A1 is a cell reference to the top left cell. + Names must not start with the letters C or R followed by a number; also single characters C and R are not allowed as names. See the ADDRESS function for more information. + Names for cell ranges must not include blanks. Blanks are allowed within names for single cells, sheets and documents. + Naming cells and formulas + A good way of making the references to cells and cell ranges in formulas legible is to give the ranges names. For example, you can name the range A1:B2 Start. You can then write a formula such as "=SUM(Start)". Even after you insert or delete rows or columns, $[officename] still correctly assigns the ranges identified by name. Range names must not contain any spaces. + For example, it is much easier to read a formula for sales tax if you can write "= Amount * Tax_rate" instead of "= A5 * B12". In this case, you would name cell A5 "Amount" and cell B12 "Tax_rate." + Use the Define Names dialog to define names for formulas or parts of formulas you need more often. In order to specify range names, + + + Select a cell or range of cells, then choose Sheet - Named Ranges and Expressions - Define. The Define Names dialog appears. + + + Type the name of the selected area in the Name field. Click Add. The newly defined name appears in the list below. Click OK to close the dialog. + + + You can also name other cell ranges in this dialog by entering the name in the field and then selecting the respective cells. + If you type the name in a formula, after the first few characters entered you will see the entire name as a tip. + + + Press the Enter key in order to accept the name from the tip. + + + If more than one name starts with the same characters, you can scroll forward through all the names using the CommandCtrl + Tab keys and backward using the Shift + CommandCtrl + Tab keys.mw copied contents from Calc guide address_byname.xhp + + +
+ Sheet - Named Ranges and Expressions - Define + + + mw deleted one EMBED paragraph and copied two EMBED paragraphs from Calc guide address_byname.xhp +
+ + diff --git a/helpcontent2/source/text/scalc/guide/webquery.xhp b/helpcontent2/source/text/scalc/guide/webquery.xhp new file mode 100644 index 000000000..c98461be3 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/webquery.xhp @@ -0,0 +1,107 @@ + + + + + + + + + + +Inserting External Data in Table (WebQuery) +/text/scalc/guide/webquery.xhp + + + +HTML WebQuery +ranges; inserting in tables +external data; inserting +tables; inserting external data +web pages; importing data +WebQuery filter +inserting; external data +data sources; external data +UFI: removed "external data;WebQuery" because both index entries "external data" led to this page. +Inserting External Data in Table (WebQuery) + +With the help of the Web Page Query ($[officename] Calc) import filter, you can insert tables from HTML documents in a Calc spreadsheet. +You can use the same method to insert ranges defined by name from a Calc or Microsoft Excel spreadsheet. +The following insert methods are available: +Inserting by Dialog + + +Set the cell cursor at the cell where the new content will be inserted. + + +Choose Sheet - External Links. This opens the External Data dialog. + + +Enter the URL of the HTML document or the name of the spreadsheet. Press Enter when finished. Click the Browse button to open a file selection dialog.only after Enter the URL will be requested from the net. + + +In the large list box of the dialog, select the named ranges or tables you want to insert. + + +You can also specify that the ranges or tables are updated every n seconds. + + +The import filter can create names for cell ranges on the fly. As much formatting as possible is retained, while the filter intentionally does not load any images. +Inserting by Navigator + + +Open two documents: the $[officename] Calc spreadsheet in which the external data is to be inserted (target document) and the document from which the external data derives (source document). + + +In the target document open the Navigator. + + +In the lower combo box of the Navigator select the source document. The Navigator now shows the range names and database ranges or the tables contained in the source document. + + +In the Navigator select the Insert as link drag mode +Icon + . + + +Drag the desired external data from the Navigator into the target document. + + +If you have loaded an HTML document with the Web Page Query filter as the source document, you will find the tables in the Navigator, named continuously from "HTML_table1" onwards, and also two range names that have been created: + + + +HTML_all - designates the entire document + + + +HTML_tables - designates all HTML tables in the document + + +Editing the external data + + +Open Edit - Links. Here you can edit the link to the external data. + + +
+External data dialog + +
+ + diff --git a/helpcontent2/source/text/scalc/guide/wildcards.xhp b/helpcontent2/source/text/scalc/guide/wildcards.xhp new file mode 100644 index 000000000..6f8c46fe4 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/wildcards.xhp @@ -0,0 +1,93 @@ + + + + + + + Using Wildcards in Formulas + /text/scalc/guide/wildcards.xhp + + + + + + wildcards in formulas + wildcards;examples + +

Using Wildcards in Formulas

+ Wildcards are special characters that can be used in search strings that are passed as arguments to some Calc functions. They can also be used to define search criteria in the Find & Replace dialog. The use of wildcards enables the definition of more advanced search parameters with a single search string. + %PRODUCTNAME Calc supports either wildcards or regular expressions as arguments depending on the current application settings. By default %PRODUCTNAME Calc is set to support wildcards instead of regular expressions. + To make sure wildcards are supported, go to %PRODUCTNAME - Preferences - %PRODUCTNAME Calc - CalculateTools - Options - %PRODUCTNAME Calc - Calculate and check if the option Enable wildcards in formulas is selected. Note that you can use this dialog to switch to regular expressions by choosing Enable regular expressions in formulas or choose to support neither wildcards nor regular expressions. + The following wildcards are supported: + + + + Wildcard + + + Description + + + + + ? (question mark) + + + Matches any single character. For example, the search string "b?g" matches “bag” and “beg” but will not match "boog" or "mug". + Note that it will not match "bg" as well, since "?" must match exactly one character. The "?" wildcard does not correspond to a zero-character match. + + + + + * (asterisk) + + + Matches any sequence of characters, including an empty string. For example, the search string "*cast" will match “cast”, “forecast”, and “outcast”, but will not match "forecaster" using default %PRODUCTNAME settings. + If the option Search criteria = and <> must apply to whole cells is disabled in %PRODUCTNAME - Preferences - %PRODUCTNAME Calc - CalculateTools - Options - %PRODUCTNAME Calc - Calculate, then "forecaster" will be a match using the "*cast" search string. + + + + + ~ (tilde) + + + Escapes the special meaning of a question mark, asterisk, or tilde character that follows immediately after the tilde character. + For example, the search string "why~?" matches “why?” but will not match "whys" nor "why~s". + + +
+ Wildcards are supported in %PRODUCTNAME Calc and in Microsoft Excel. Therefore, if interoperability between both applications is needed, choose to work with wildcards instead of regular expressions. Conversely, if interoperability is not necessary, consider using regular expressions for more powerful search capabilities. +

Supported Spreadsheet Functions

+ Wildcards are supported by the following spreadsheet functions: + + + Database functions: DAVERAGE, DCOUNT, DCOUNTA, DGET, DMAX, DMIN, DPRODUCT, DSTDEV, DSTDEVP, DSUM, DVAR and DVARP. + + + Conditional functions: AVERAGEIF, AVERAGEIFS, COUNTIF, COUNTIFS, MAXIFS, MINIFS, SUMIF and SUMIFS. + + + Lookup functions: HLOOKUP, LOOKUP and VLOOKUP. + + + Other functions: MATCH and SEARCH. + + +

Examples of Wildcards in Formulas

+ The following examples consider that the options Enable wildcards in formulas and Search criteria = and <> must apply to whole cells are enabled in %PRODUCTNAME - Preferences - %PRODUCTNAME Calc - CalculateTools - Options - %PRODUCTNAME Calc - Calculate. + =COUNTIF(A1:A10;"Chi*") counts the number of cells in the range A1:A10 containing strings that start with "Chi" followed by zero or more characters. + =SUMIF(A1:A5;"A??";B1:B5) sums the values in B1:B5 whose corresponding values in A1:A5 start with "A" followed by exactly two other characters. + Wildcard comparisons are not case sensitive, hence "A?" will match both "A1" and "a1". + +
+ +
+ + diff --git a/helpcontent2/source/text/scalc/guide/year2000.xhp b/helpcontent2/source/text/scalc/guide/year2000.xhp new file mode 100644 index 000000000..8ff336c55 --- /dev/null +++ b/helpcontent2/source/text/scalc/guide/year2000.xhp @@ -0,0 +1,51 @@ + + + + + + + + +19xx/20xx Years +/text/scalc/guide/year2000.xhp + + +Sun Microsystems, Inc. + + + +years; 2-digits +dates; 19xx/20xx + +19xx/20xx Years + +
+The year in a date entry is often entered as two digits. Internally, the year is managed by $[officename] as four digits, so that in the calculation of the difference from 1/1/99 to 1/1/01, the result will correctly be two years. + + +Under %PRODUCTNAME - PreferencesTools - Options - $[officename] - General you can define the century that is used when you enter a year with only two digits. The default is 1930 to 2029. + + +This means that if you enter a date of 1/1/30 or higher, it will be treated internally as 1/1/1930 or higher. All lower two-digit years apply to the 20xx century. So, for example, 1/1/20 is converted into 1/1/2020. +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/main0000.xhp b/helpcontent2/source/text/scalc/main0000.xhp new file mode 100644 index 000000000..41e14e8d9 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0000.xhp @@ -0,0 +1,41 @@ + + + + + +Welcome to the $[officename] Calc Help +/text/scalc/main0000.xhp + + + + +

Welcome to the $[officename] Calc Help

+ +

How to Work With $[officename] Calc

+ + +List of Functions by Category + +

$[officename] Calc Menus, Toolbars, and Keys

+ + + + + + diff --git a/helpcontent2/source/text/scalc/main0100.xhp b/helpcontent2/source/text/scalc/main0100.xhp new file mode 100644 index 000000000..d0eced59e --- /dev/null +++ b/helpcontent2/source/text/scalc/main0100.xhp @@ -0,0 +1,47 @@ + + + + + +Menus +/text/scalc/main0100.xhp + + +Sun Microsystems, Inc. + + + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0101.xhp b/helpcontent2/source/text/scalc/main0101.xhp new file mode 100644 index 000000000..dd1517741 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0101.xhp @@ -0,0 +1,60 @@ + + + + + + + File + /text/scalc/main0101.xhp + + + + + + +
+ + +

File

+These commands apply to the current document, open a new document, or close the application. +
+ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0102.xhp b/helpcontent2/source/text/scalc/main0102.xhp new file mode 100644 index 000000000..338eb7378 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0102.xhp @@ -0,0 +1,59 @@ + + + + + + + Edit + /text/scalc/main0102.xhp + + + + + + +
+ + +

Edit

+This menu contains commands for editing the contents of the current document. +
+ + + + + + + + + + + + + + +

Links

+ + +

Object

+ + + + + diff --git a/helpcontent2/source/text/scalc/main0103.xhp b/helpcontent2/source/text/scalc/main0103.xhp new file mode 100644 index 000000000..d2df5fe2f --- /dev/null +++ b/helpcontent2/source/text/scalc/main0103.xhp @@ -0,0 +1,79 @@ + + + + + + + View + /text/scalc/main0103.xhp + + + + + + +
+ + +

View

+This menu contains commands for controlling the on-screen display of the document. +
+ + +

Normal

+Displays the normal layout view of the sheet. + +

Page Break

+ + + + + + +

View Grid lines

+Toggle the visibility of grid lines for the current sheet. + + + +

Show Formula

+Display the cell formula expression instead of the calculated result. + +

Comments

+Display the cell comments for the current spreadsheet document. + + + + + + + +

Gallery

+ + + +

+ + + + +

Zoom

+ + + + diff --git a/helpcontent2/source/text/scalc/main0104.xhp b/helpcontent2/source/text/scalc/main0104.xhp new file mode 100644 index 000000000..48df92e44 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0104.xhp @@ -0,0 +1,78 @@ + + + + + + + Insert + /text/scalc/main0104.xhp + + + +
+ +

Insert

+The Insert menu contains commands for inserting new elements, such as images, text boxes, object, media, cell names and much more into the current sheet. +
+ + + +

Chart

+Inserts a chart. + + + + + + + + + + +

+ + + +

Floating Frame

+ + + + +

Hyperlink

+ + +

Special Character

+ + + + +

Date

+Inserts the current date in the cell. + +

Time

+Inserts the current time in the cell. + +

Field

+Opens a submenu for selecting the date, sheet name or document title in the cell. + + + + + + diff --git a/helpcontent2/source/text/scalc/main0105.xhp b/helpcontent2/source/text/scalc/main0105.xhp new file mode 100644 index 000000000..a51652e42 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0105.xhp @@ -0,0 +1,77 @@ + + + + + + + Format + /text/scalc/main0105.xhp + + + + + + +
+ + +

Format

+The Format menu contains commands for formatting selected cells, objects, and cell contents in your document. +
+ + + +

Cells

+ + + + + + + + + + +

Character

+ + +

Paragraph

+ + +

AutoFormat

+ + +

Conditional Formatting

+ + + + + + + + + +

Control

+ + +

Form

+ + + + diff --git a/helpcontent2/source/text/scalc/main0106.xhp b/helpcontent2/source/text/scalc/main0106.xhp new file mode 100644 index 000000000..908491258 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0106.xhp @@ -0,0 +1,72 @@ + + + + + + + Tools + /text/scalc/main0106.xhp + + + +
+ +

Tools

+The Tools menu contains commands to check spelling, to trace sheet references, to find mistakes and to define scenarios. +
+You can also create and assign macros and configure the look and feel of toolbars, menus, keyboard, and set the default options for $[officename] applications. + + + + + + +

AutoCorrect Options

+ + + + + +

ImageMap

+ + +

Goal Seek

+ + + + +

Scenarios

+ + + + + + + + + + + + + +

Customize

+ + + + diff --git a/helpcontent2/source/text/scalc/main0107.xhp b/helpcontent2/source/text/scalc/main0107.xhp new file mode 100644 index 000000000..5f766eecd --- /dev/null +++ b/helpcontent2/source/text/scalc/main0107.xhp @@ -0,0 +1,42 @@ + + + + + + + Window + /text/scalc/main0107.xhp + + + + + + +
+ + +

Window

+Contains commands for manipulating and displaying document windows. +
+ + + + + + diff --git a/helpcontent2/source/text/scalc/main0112.xhp b/helpcontent2/source/text/scalc/main0112.xhp new file mode 100644 index 000000000..45006fe18 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0112.xhp @@ -0,0 +1,55 @@ + + + + + + Data + /text/scalc/main0112.xhp + + + +
+

Data

+ Use the Data menu commands to edit the data in the current sheet. You can define ranges, sort and filter the data, calculate results, outline data, and create a pivot table. +
+ + + + + + + + + + + + + +

Streams

+ + + Data Provider temporarily removed. Feature and help file not finished yet. + Link is: href="text/scalc/01/data_provider.xhp#data_provider" + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0116.xhp b/helpcontent2/source/text/scalc/main0116.xhp new file mode 100644 index 000000000..84036c545 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0116.xhp @@ -0,0 +1,64 @@ + + + + + + + Sheet + /text/scalc/main0116.xhp + + + + + + +
+ + +

Sheet

+This menu contains commands to modify and manage a sheet and its elements. +
+

Insert Rows

+ +

Insert Columns

+ + + + + + + + +

Move or Copy Sheet

+ + +

Show Sheet

+ + +

Delete Sheet

+ + +

Sheet Tab Color

+ + +

Sheet Events

+ + + + diff --git a/helpcontent2/source/text/scalc/main0200.xhp b/helpcontent2/source/text/scalc/main0200.xhp new file mode 100644 index 000000000..d7ed89cff --- /dev/null +++ b/helpcontent2/source/text/scalc/main0200.xhp @@ -0,0 +1,76 @@ + + + + + + + Toolbars + /text/scalc/main0200.xhp + + + Sun Microsystems, Inc. + + + + +
+

Toolbars

+ This submenu lists the toolbars that are available in spreadsheets. This overview describes the default toolbar configuration for %PRODUCTNAME. +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+
+ +
+ + diff --git a/helpcontent2/source/text/scalc/main0202.xhp b/helpcontent2/source/text/scalc/main0202.xhp new file mode 100644 index 000000000..7bdab0b72 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0202.xhp @@ -0,0 +1,135 @@ + + + + + +Formatting Bar +/text/scalc/main0202.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Formatting Bar

+The Formatting bar contains basic commands for applying manually formatting. +
+ + + + + + + + + + + + +

Font Color

+ + +

Align Left

+ + +

Align Center Horizontally

+ + +

Align Right

+ + +

Justify

+ + + + + + + + + + + + + + + + + + + + +

Align Top

+ + +

Align Center Vertically

+ + +

Align Bottom

+ + + +

Number Format : Date

+Applies the date format to the selected cells. + +

Number Format: Exponential

+Applies the exponential format to the selected cells. +

Additional icons

+If CTL support is enabled, two additional icons are visible. + +

Left-To-Right

+ + + + +left to right icon + + + +The text is entered from left to right. + + +
+ +

Right-To-Left

+ + + + +right to left icon + + + +The text formatted in a complex text layout language is entered from right to left. + + +
+UFI: inserted .uno:Align... help ids here, had to be removed from shared/01/05340300.xhp + +Aligns the contents of the cell to the left. + +Aligns the contents of the cell to the right. + +Horizontally centers the contents of the cell. + +Aligns the contents of the cell to the left and right cell borders. + + diff --git a/helpcontent2/source/text/scalc/main0203.xhp b/helpcontent2/source/text/scalc/main0203.xhp new file mode 100644 index 000000000..a401516d1 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0203.xhp @@ -0,0 +1,69 @@ + + + + + +Drawing Object Properties Bar +/text/scalc/main0203.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Drawing Object Properties Bar

+The Drawing Object Properties Bar for objects that you select in the sheet contains formatting and alignment commands. +
+ + + + +

Line Style

+ + +

Line Width

+ + +

Line Color

+ + + + +

Background Color

+ + + + + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0205.xhp b/helpcontent2/source/text/scalc/main0205.xhp new file mode 100644 index 000000000..bab10453a --- /dev/null +++ b/helpcontent2/source/text/scalc/main0205.xhp @@ -0,0 +1,87 @@ + + + + + +Text Formatting Bar +/text/scalc/main0205.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Text Formatting Bar

+The Text Formatting Bar that is displayed when the cursor is in a text object, such as a text box or a drawing object, contains formatting and alignment commands. +
+ + + + + + + + + + +

Font Color

+ + +

Line Spacing: 1

+ + +

Line Spacing: 1.5

+ + +

Line Spacing: 2

+ + +

Align Left

+ + +

Centered

+ + +

Align Right

+ + +

Justify

+ + +

Superscript

+ + +

Subscript

+ + +

Character

+ + +

Paragraph

+ + + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0206.xhp b/helpcontent2/source/text/scalc/main0206.xhp new file mode 100644 index 000000000..6844595db --- /dev/null +++ b/helpcontent2/source/text/scalc/main0206.xhp @@ -0,0 +1,51 @@ + + + + + +Formula Bar +/text/scalc/main0206.xhp + + +Sun Microsystems, Inc. + + + +
+ + +

Formula Bar

+Use this bar to enter formulas. +
+ + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0208.xhp b/helpcontent2/source/text/scalc/main0208.xhp new file mode 100644 index 000000000..870ecdde1 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0208.xhp @@ -0,0 +1,44 @@ + + + + + + + + + Status Bar + /text/scalc/main0208.xhp + + + +
+

Status Bar

+ The Status Bar displays information about the current sheet. +
+ + + + + + +

Digital Signature

+ See also Digital Signatures. + + + diff --git a/helpcontent2/source/text/scalc/main0210.xhp b/helpcontent2/source/text/scalc/main0210.xhp new file mode 100644 index 000000000..9d8053d24 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0210.xhp @@ -0,0 +1,60 @@ + + + + + + + Print Preview Bar + /text/scalc/main0210.xhp + + + Sun Microsystems, Inc. + + + + + + + + + + + + + + + + +

Full Screen

+Hides the menus and toolbars. To exit the full screen mode, click the Full Screen button. +

Format Page

+ +

Margins

+Shows or hides margins of the page. Margins can be dragged by the mouse, and also can be set on Page tab of Page Style dialog. +

Scaling Factor

+This slide defines a page scale for the printed spreadsheet. Scaling factor can be set on Sheet tab of Page Style dialog, too. +

Close Preview

+To exit the print preview, click the Close Preview button. + + diff --git a/helpcontent2/source/text/scalc/main0214.xhp b/helpcontent2/source/text/scalc/main0214.xhp new file mode 100644 index 000000000..6aaa57760 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0214.xhp @@ -0,0 +1,57 @@ + + + + + +Image Bar +/text/scalc/main0214.xhp + + +Sun Microsystems, Inc. + + + +
+

Image Bar

+The Image bar is displayed when you insert or select an image in a sheet. +
+ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0218.xhp b/helpcontent2/source/text/scalc/main0218.xhp new file mode 100644 index 000000000..2430fd6b4 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0218.xhp @@ -0,0 +1,70 @@ + + + + + +Tools Bar +/text/scalc/main0218.xhp + + +Sun Microsystems, Inc. + + + +
+ +

Tools Bar

+Use the Tools bar to access commonly used commands. +
+ + + + + +

Controls

+ + + + + +

Choose Themes

+ + + + + + +

Advanced Filter

+ +

Start

+ +

Euro Converter

+ +

Define

+ +

Goal Seek

+ + + + + + + + + diff --git a/helpcontent2/source/text/scalc/main0503.xhp b/helpcontent2/source/text/scalc/main0503.xhp new file mode 100644 index 000000000..27e04b5f8 --- /dev/null +++ b/helpcontent2/source/text/scalc/main0503.xhp @@ -0,0 +1,51 @@ + + + + + +$[officename] Calc Features +/text/scalc/main0503.xhp + + +Sun Microsystems, Inc. + + + + + +
+

$[officename] Calc Features

+ $[officename] Calc is a spreadsheet application that you can use to calculate, analyze, and manage your data. You can also import and modify Microsoft Excel spreadsheets. +
+

Calculations

+ $[officename] Calc provides you with functions, including statistical and banking functions, that you can use to create formulas to perform complex calculations on your data. + You can also use the Function Wizard to help you create your formulas. +

What-If Calculations

+ An interesting feature is to be able to immediately view the results of changes made to one factor of calculations that are composed of several factors. For instance, you can see how changing the time period in a loan calculation affects the interest rates or repayment amounts. Furthermore, you can manage larger tables by using different predefined scenarios. +

Database Functions

+ Use spreadsheets to arrange, store, and filter your data. + $[officename] Calc lets you drag-and-drop tables from databases, or lets you use a spreadsheet as a data source for creating form letters in $[officename] Writer. +

Arranging Data

+ With a few mouse-clicks, you can reorganize your spreadsheet to show or hide certain data ranges, or to format ranges according to special conditions, or to quickly calculate subtotals and totals. +

Dynamic Charts

+ $[officename] Calc lets you present spreadsheet data in dynamic charts that update automatically when the data changes. +

Opening and Saving Microsoft Files

+ Use the $[officename] filters to convert Excel files, or to open and save in a variety of other formats. + + -- cgit v1.2.3