Skip to content

Commit ab2002a

Browse files
review changes updated
1 parent 29e4343 commit ab2002a

File tree

1 file changed

+31
-35
lines changed

1 file changed

+31
-35
lines changed

WindowsForms/Calculation-Engine/Supported-Formulas/Financial-Formulas.md

Lines changed: 31 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -749,7 +749,7 @@ _INTRATE(settlement, maturity, investment, redemption, [basis])_
749749

750750
## NOMINAL
751751

752-
The function `NOMINAL` returns the nominal annual interest rate, given the effective rate and the number of compounding periods per year.
752+
The `NOMINAL` function returns the nominal annual interest rate, given the effective rate and the number of compounding periods per year.
753753

754754
**Syntax:**
755755

@@ -763,21 +763,19 @@ _NOMINAL(effect_rate, npery)_
763763

764764
**Remarks:**
765765

766-
* Npery is truncated to an integer.
767-
768-
* If either argument is non numeric, `NOMINAL` returns the `#VALUE!` error value.
766+
* npery is truncated to an integer.
769767

770-
* If effect_rate ≤ 0 or if npery < 1, `NOMINAL` returns the `#NUM!` error value.
768+
* If either argument is non-numeric, `NOMINAL` returns the `#VALUE!` error.
771769

772-
* `NOMINAL` is related to `EFFECT` function. The relationship between `NOMINAL` and `EFFECT` is shown in the following equation:
770+
* If effect_rate is less than or equal to 0 or if npery is less than 1, `NOMINAL` returns the `#NUM!` error value.
773771

774-
`effective_rate = (1 + (nominal_rate / npery))^npery - 1`
772+
* The `NOMINAL` function is related to the `EFFECT` function, which calculates the effective annual interest rate based on the nominal rate and the number of compounding periods.
775773

776774

777775

778776
## MDURATION
779777

780-
The function `MDURATION` returns the modified Macaulay duration for a security with an assumed par value of $100.
778+
The `MDURATION` function returns the modified Macaulay duration for a security with an assumed par value of $100.
781779

782780
**Syntax:**
783781

@@ -795,7 +793,7 @@ _MDURATION(settlement, maturity, coupon, yld, frequency, [basis])_
795793

796794
* frequency: The number of coupon payments per year (1 for annual, 2 for semiannual, 4 for quarterly).
797795

798-
* basis (Optional): The day count basis to use (default is 0: US (NASD) 30/360):
796+
* basis (Optional): The day-count convention to use (default is 0: US (NASD) 30/360):
799797

800798
* 0 or omitted: US (NASD) 30/360
801799

@@ -809,23 +807,23 @@ _MDURATION(settlement, maturity, coupon, yld, frequency, [basis])_
809807

810808
**Remarks:**
811809

812-
* Dates are stored as serial numbers. For example, January 1, 1900 is 1, and January 1, 2008 is 39448.
810+
* Dates are stored as serial numbers. (e.g., January 1, 1900, is represented as 1).
813811

814-
* If settlement or maturity is not valid, `MDURATION` returns `#VALUE!`.
812+
* If settlement or maturity is a not valid date, `MDURATION` returns the `#VALUE!` error.
815813

816-
* If yld < 0 or coupon < 0, it returns `#NUM!`. If frequency is not 1, 2, or 4, it returns `#NUM!`.
814+
* If yld or coupon less than 0, or if frequency is not 1, 2, or 4, `MDURATION` returns the `#NUM!` error.
817815

818-
* If basis is outside the range 0-4, it returns `#NUM!`.
816+
* If basis is outside the range 0-4, it returns the `#NUM!` error.
819817

820-
* If settlement is greater than or equal to maturity, it returns `#NUM!`.
818+
* If settlement is greater than or equal to maturity, `MDURATION` returns the `#NUM!` error.
821819

822-
* Equation to calculate `MDURATION` is `Modified Duration = Macaulay Duration / (1 + (yld / frequency))`.
820+
* `MDURATION` adjusts the Macaulay duration to account for changes in interest rates.
823821

824822

825823

826824
## PDURATION
827825

828-
The function `PDURATION` returns the number of periods required by an investment to reach a specified value.
826+
The `PDURATION` function returns the number of periods required by an investment to reach a specified value.
829827

830828
**Syntax:**
831829

@@ -841,19 +839,17 @@ _PDURATION(rate, pv, fv)_
841839

842840
**Remarks:**
843841

844-
* If rate is less than or equal to 0, or if pv or fv is less than or equal to 0, `PDURATION` returns the `#NUM!` error value.
845-
846-
* If any argument is non numeric, `PDURATION` returns the `#VALUE!` error value.
842+
* If rate is less than or equal to 0, or if pv or fv is less than or equal to 0, `PDURATION` returns the `#NUM!` error.
847843

848-
* The `PDURATION` function calculates the number of periods required using the following equation:
844+
* If any argument is non-numeric, `PDURATION` returns the `#VALUE!` error.
849845

850-
`PDURATION = LOG(fv / pv) / LOG(1 + rate)`
846+
* `PDURATION` calculates how many periods are needed for an investment to grow from its present value to the desired future value, based on the specified interest rate.
851847

852848

853849

854850
## COUPDAYS
855851

856-
The function `COUPDAYS` returns the number of days in the coupon period that contains the settlement date.
852+
The `COUPDAYS` function returns the number of days in the coupon period that contains the settlement date.
857853

858854
**Syntax:**
859855

@@ -867,7 +863,7 @@ _COUPDAYS(settlement, maturity, frequency, [basis])_
867863

868864
* frequency: The number of coupon payments per year (1 for annual, 2 for semiannual, 4 for quarterly).
869865

870-
* basis (Optional): The type of day count basis to use:
866+
* basis (Optional): The day count basis to use:
871867

872868
* 0 or omitted: US (NASD) 30/360
873869

@@ -881,7 +877,7 @@ _COUPDAYS(settlement, maturity, frequency, [basis])_
881877

882878
**Remarks:**
883879

884-
* Dates are stored as serial numbers. For example, January 1, 1900 is 1, and January 1, 2008 is 39448.
880+
* Dates are stored as serial numbers. (e.g., January 1, 1900, is represented as 1).
885881

886882
* If settlement or maturity is not a valid date, `COUPDAYS` returns `#VALUE!`.
887883

@@ -895,7 +891,7 @@ _COUPDAYS(settlement, maturity, frequency, [basis])_
895891

896892
## COUPDAYBS
897893

898-
The function `COUPDAYBS` returns the number of days from the beginning of a coupon period until its settlement date.
894+
The `COUPDAYBS` function returns the number of days from the beginning of a coupon period until its settlement date.
899895

900896
**Syntax:**
901897

@@ -923,9 +919,9 @@ _COUPDAYBS(settlement, maturity, frequency, [basis])_
923919

924920
**Remarks:**
925921

926-
* Dates are stored as serial numbers. For example, January 1, 1900 is 1, and January 1, 2008 is 39448.
922+
* Dates are stored as serial numbers. (e.g., January 1, 1900, is represented as 1).
927923

928-
* If settlement or maturity is not valid, `COUPDAYBS` returns `#VALUE!`.
924+
* If settlement or maturity is not a valid date, `COUPDAYBS` returns `#VALUE!`.
929925

930926
* If frequency is any number other than 1, 2, or 4, `COUPDAYBS` returns `#NUM!`.
931927

@@ -965,9 +961,9 @@ _COUPDAYSNC(settlement, maturity, frequency, [basis])_
965961

966962
**Remarks:**
967963

968-
* Dates are stored as serial numbers. For example, January 1, 1900 is 1, and January 1, 2008 is 39448.
964+
* Dates are stored as serial numbers. (e.g., January 1, 1900, is represented as 1).
969965

970-
* If settlement or maturity is not valid, `COUPDAYSNC` returns `#VALUE!`.
966+
* If settlement or maturity is not a valid date, `COUPDAYSNC` returns `#VALUE!`.
971967

972968
* If frequency is any number other than 1, 2, or 4, `COUPDAYSNC` returns `#NUM!`.
973969

@@ -1007,9 +1003,9 @@ _COUPPCD(settlement, maturity, frequency, [basis])_
10071003

10081004
**Remarks:**
10091005

1010-
* Dates are stored as serial numbers. For example, January 1, 1900 is 1, and January 1, 2008 is 39448.
1006+
* Dates are stored as serial numbers. (e.g., January 1, 1900, is represented as 1).
10111007

1012-
* If settlement or maturity is not valid, `COUPPCD` returns `#VALUE!`.
1008+
* If settlement or maturity is not a valid date, `COUPPCD` returns `#VALUE!`.
10131009

10141010
* If frequency is any number other than 1, 2, or 4, `COUPPCD` returns `#NUM!`.
10151011

@@ -1049,9 +1045,9 @@ _COUPNCD(settlement, maturity, frequency, [basis])_
10491045

10501046
**Remarks:**
10511047

1052-
* Dates are stored as serial numbers. For example, January 1, 1900 is 1, and January 1, 2008 is 39448.
1048+
* Dates are stored as serial numbers. (e.g., January 1, 1900, is represented as 1).
10531049

1054-
* If settlement or maturity is not valid, `COUPNCD` returns `#VALUE!`.
1050+
* If settlement or maturity is not a valid date, `COUPNCD` returns `#VALUE!`.
10551051

10561052
* If frequency is any number other than 1, 2, or 4, `COUPNCD` returns `#NUM!`.
10571053

@@ -1091,9 +1087,9 @@ _COUPNUM(settlement, maturity, frequency, [basis])_
10911087

10921088
**Remarks:**
10931089

1094-
* Dates are stored as serial numbers. For example, January 1, 1900 is 1, and January 1, 2008 is 39448.
1090+
* Dates are stored as serial numbers. (e.g., January 1, 1900, is represented as 1).
10951091

1096-
* If settlement or maturity is not valid, `COUPNUM` returns `#VALUE!`.
1092+
* If settlement or maturity is not a valid date, `COUPNUM` returns `#VALUE!`.
10971093

10981094
* If frequency is any number other than 1, 2, or 4, `COUPNUM` returns `#NUM!`.
10991095

0 commit comments

Comments
 (0)