Skip to content

financial_functions

shortfx.fxVBA.financial_functions

Access Financial Functions Module.

Description Funciones financieras compatibles con VBA/Access para cálculo de depreciación, anualidades y préstamos.

Functions

DDB(cost: float, salvage: float, life: float, period: float, factor: float = 2.0) -> float

Description Depreciación de doble saldo decreciente de un activo.

Args cost: Costo inicial del bien. salvage: Valor al término de vida útil. life: Duración de vida útil. period: Periodo para el cual se calcula depreciación. factor: Tasa de depreciación (por defecto 2.0).

Returns float: Depreciación para el periodo especificado.

Usage Example >>> ddb(1000, 100, 5, 1) 400.0

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
def DDB(
    cost: float,
    salvage: float,
    life: float,
    period: float,
    factor: float = 2.0
) -> float:
    """
    Description
        Depreciación de doble saldo decreciente de un activo.

    Args
        cost: Costo inicial del bien.
        salvage: Valor al término de vida útil.
        life: Duración de vida útil.
        period: Periodo para el cual se calcula depreciación.
        factor: Tasa de depreciación (por defecto 2.0).

    Returns
        float: Depreciación para el periodo especificado.

    Usage Example
        >>> ddb(1000, 100, 5, 1)
        400.0

    Cost
        O(1)
    """
    return _core_ddb(cost, salvage, life, period, factor)

FV(rate: float, nper: float, pmt: float, pv: float = 0, type_: int = 0) -> float

Description Valor futuro de anualidad basado en pagos periódicos constantes.

Args rate: Tasa de interés por periodo. nper: Número total de periodos de pago. pmt: Pago por periodo. pv: Valor presente (por defecto 0). type_: Tipo de pago (0=final periodo, 1=inicio periodo).

Returns float: Valor futuro.

Usage Example >>> fv(0.05/12, 12, -100, -1000) 2276.28

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
def FV(rate: float, nper: float, pmt: float, pv: float = 0, type_: int = 0) -> float:
    """
    Description
        Valor futuro de anualidad basado en pagos periódicos constantes.

    Args
        rate: Tasa de interés por periodo.
        nper: Número total de periodos de pago.
        pmt: Pago por periodo.
        pv: Valor presente (por defecto 0).
        type_: Tipo de pago (0=final periodo, 1=inicio periodo).

    Returns
        float: Valor futuro.

    Usage Example
        >>> fv(0.05/12, 12, -100, -1000)
        2276.28

    Cost
        O(1)
    """
    return _core_fv(rate, nper, pmt, pv, type_)

IPmt(rate: float, per: float, nper: float, pv: float, fv: float = 0, type_: int = 0) -> float

Description Pago de intereses para periodo dado de una anualidad.

Args rate: Tasa de interés por periodo. per: Periodo para el cual se calcula interés (1 a nper). nper: Número total de periodos. pv: Valor presente. fv: Valor futuro (por defecto 0). type_: Tipo de pago (0=final, 1=inicio).

Returns float: Pago de intereses.

Usage Example >>> ipmt(0.1/12, 1, 36, 8000) -66.67

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
def IPmt(rate: float, per: float, nper: float, pv: float, fv: float = 0, type_: int = 0) -> float:
    """
    Description
        Pago de intereses para periodo dado de una anualidad.

    Args
        rate: Tasa de interés por periodo.
        per: Periodo para el cual se calcula interés (1 a nper).
        nper: Número total de periodos.
        pv: Valor presente.
        fv: Valor futuro (por defecto 0).
        type_: Tipo de pago (0=final, 1=inicio).

    Returns
        float: Pago de intereses.

    Usage Example
        >>> ipmt(0.1/12, 1, 36, 8000)
        -66.67

    Cost
        O(1)
    """
    return _core_ipmt(rate, int(per), int(nper), pv, fv, type_)

IRR(values: List[float], guess: float = 0.1) -> float

Description Calcula Tasa Interna de Retorno (IRR) de flujos de caja.

Args values: Lista de flujos de caja (debe incluir al menos un valor negativo y uno positivo). guess: Estimación inicial (por defecto 0.1).

Returns float: Tasa interna de retorno.

Raises ValueError: Si no converge o valores inválidos.

Usage Example >>> irr([-10000, 3000, 4200, 6800]) 0.1896

Cost O(n*iterations) - método iterativo Newton-Raphson

Source code in shortfx/fxVBA/financial_functions.py 
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
def IRR(values: List[float], guess: float = 0.1) -> float:
    """
    Description
        Calcula Tasa Interna de Retorno (IRR) de flujos de caja.

    Args
        values: Lista de flujos de caja (debe incluir al menos un valor negativo y uno positivo).
        guess: Estimación inicial (por defecto 0.1).

    Returns
        float: Tasa interna de retorno.

    Raises
        ValueError: Si no converge o valores inválidos.

    Usage Example
        >>> irr([-10000, 3000, 4200, 6800])
        0.1896

    Cost
        O(n*iterations) - método iterativo Newton-Raphson
    """
    return _core_irr(values, guess)

MIRR(values: List[float], finance_rate: float, reinvest_rate: float) -> float

Description Calcula Tasa Interna de Retorno Modificada (MIRR).

Args values: Lista de flujos de caja. finance_rate: Tasa de interés para flujos negativos (financiamiento). reinvest_rate: Tasa de interés para flujos positivos (reinversión).

Returns float: Tasa interna de retorno modificada.

Usage Example >>> mirr([-10000, 3000, 4200, 6800], 0.1, 0.12) 0.1326

Cost O(n) donde n es número de flujos

Source code in shortfx/fxVBA/financial_functions.py 
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
def MIRR(values: List[float], finance_rate: float, reinvest_rate: float) -> float:
    """
    Description
        Calcula Tasa Interna de Retorno Modificada (MIRR).

    Args
        values: Lista de flujos de caja.
        finance_rate: Tasa de interés para flujos negativos (financiamiento).
        reinvest_rate: Tasa de interés para flujos positivos (reinversión).

    Returns
        float: Tasa interna de retorno modificada.

    Usage Example
        >>> mirr([-10000, 3000, 4200, 6800], 0.1, 0.12)
        0.1326

    Cost
        O(n) donde n es número de flujos
    """
    return _core_mirr(values, finance_rate, reinvest_rate)

NPV(rate: float, values: List[float]) -> float

Description Calcula Valor Presente Neto (NPV) de flujos de caja.

Args rate: Tasa de descuento por periodo. values: Lista de flujos de caja (valores).

Returns float: Valor presente neto.

Usage Example >>> npv(0.1, [-10000, 3000, 4200, 6800]) 1188.44

Cost O(n) donde n es número de flujos

Source code in shortfx/fxVBA/financial_functions.py 
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
def NPV(rate: float, values: List[float]) -> float:
    """
    Description
        Calcula Valor Presente Neto (NPV) de flujos de caja.

    Args
        rate: Tasa de descuento por periodo.
        values: Lista de flujos de caja (valores).

    Returns
        float: Valor presente neto.

    Usage Example
        >>> npv(0.1, [-10000, 3000, 4200, 6800])
        1188.44

    Cost
        O(n) donde n es número de flujos
    """
    return _core_npv(rate, values)

NPer(rate: float, pmt: float, pv: float, fv: float = 0.0, type_: int = 0) -> float

Description Calcula número de períodos para inversión o préstamo.

Args rate: Tasa de interés por periodo. pmt: Pago por periodo. pv: Valor presente. fv: Valor futuro (por defecto 0). type_: 0 = pago al final, 1 = pago al inicio.

Returns float: Número de períodos.

Usage Example >>> nper(0.01, -100, 1000, 0) 10.4

Cost O(1) con cálculo logarítmico

Source code in shortfx/fxVBA/financial_functions.py 
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
def NPer(rate: float, pmt: float, pv: float, fv: float = 0.0, type_: int = 0) -> float:
    """
    Description
        Calcula número de períodos para inversión o préstamo.

    Args
        rate: Tasa de interés por periodo.
        pmt: Pago por periodo.
        pv: Valor presente.
        fv: Valor futuro (por defecto 0).
        type_: 0 = pago al final, 1 = pago al inicio.

    Returns
        float: Número de períodos.

    Usage Example
        >>> nper(0.01, -100, 1000, 0)
        10.4

    Cost
        O(1) con cálculo logarítmico
    """
    return _core_nper(rate, pmt, pv, fv, type_)

PPmt(rate: float, per: float, nper: float, pv: float, fv: float = 0, type_: int = 0) -> float

Description Pago principal para periodo dado de una anualidad.

Args rate: Tasa de interés por periodo. per: Periodo (1 a nper). nper: Número total de periodos. pv: Valor presente. fv: Valor futuro (por defecto 0). type_: Tipo de pago (0=final, 1=inicio).

Returns float: Pago principal.

Usage Example >>> ppmt(0.1/12, 1, 36, 8000) -191.47

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
def PPmt(rate: float, per: float, nper: float, pv: float, fv: float = 0, type_: int = 0) -> float:
    """
    Description
        Pago principal para periodo dado de una anualidad.

    Args
        rate: Tasa de interés por periodo.
        per: Periodo (1 a nper).
        nper: Número total de periodos.
        pv: Valor presente.
        fv: Valor futuro (por defecto 0).
        type_: Tipo de pago (0=final, 1=inicio).

    Returns
        float: Pago principal.

    Usage Example
        >>> ppmt(0.1/12, 1, 36, 8000)
        -191.47

    Cost
        O(1)
    """
    return _core_ppmt(rate, int(per), int(nper), pv, fv, type_)

PV(rate: float, nper: float, pmt_: float, fv: float = 0, type_: int = 0) -> float

Description Valor actual de una anualidad.

Args rate: Tasa de interés por periodo. nper: Número total de periodos. pmt_: Pago por periodo. fv: Valor futuro (por defecto 0). type_: Tipo de pago (0=final, 1=inicio).

Returns float: Valor presente.

Usage Example >>> pv(0.08/12, 20*12, -500) 59777.15

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
def PV(rate: float, nper: float, pmt_: float, fv: float = 0, type_: int = 0) -> float:
    """
    Description
        Valor actual de una anualidad.

    Args
        rate: Tasa de interés por periodo.
        nper: Número total de periodos.
        pmt_: Pago por periodo.
        fv: Valor futuro (por defecto 0).
        type_: Tipo de pago (0=final, 1=inicio).

    Returns
        float: Valor presente.

    Usage Example
        >>> pv(0.08/12, 20*12, -500)
        59777.15

    Cost
        O(1)
    """
    return _core_pv(rate, nper, pmt_, fv, type_)

Pmt(rate: float, nper: float, pv: float, fv: float = 0, type_: int = 0) -> float

Description Pago para anualidad basado en pagos periódicos constantes.

Args rate: Tasa de interés por periodo. nper: Número total de periodos. pv: Valor presente. fv: Valor futuro (por defecto 0). type_: Tipo de pago (0=final, 1=inicio).

Returns float: Pago por periodo.

Usage Example >>> pmt(0.1/12, 36, 8000) -258.14

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
def Pmt(rate: float, nper: float, pv: float, fv: float = 0, type_: int = 0) -> float:
    """
    Description
        Pago para anualidad basado en pagos periódicos constantes.

    Args
        rate: Tasa de interés por periodo.
        nper: Número total de periodos.
        pv: Valor presente.
        fv: Valor futuro (por defecto 0).
        type_: Tipo de pago (0=final, 1=inicio).

    Returns
        float: Pago por periodo.

    Usage Example
        >>> pmt(0.1/12, 36, 8000)
        -258.14

    Cost
        O(1)
    """
    return _core_pmt(rate, nper, pv, fv, type_)

Rate(nper: float, pmt_: float, pv: float, fv: float = 0, type_: int = 0, guess: float = 0.1) -> float

Description Tasa de interés por periodo de una anualidad.

Args nper: Número total de periodos. pmt_: Pago por periodo. pv: Valor presente. fv: Valor futuro (por defecto 0). type_: Tipo de pago (0=final, 1=inicio). guess: Estimación inicial (por defecto 0.1).

Returns float: Tasa de interés por periodo.

Usage Example >>> rate(60, -1000, 50000) 0.015

Cost O(n) iteraciones de Newton-Raphson

Source code in shortfx/fxVBA/financial_functions.py 
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
def Rate(
    nper: float,
    pmt_: float,
    pv: float,
    fv: float = 0,
    type_: int = 0,
    guess: float = 0.1
) -> float:
    """
    Description
        Tasa de interés por periodo de una anualidad.

    Args
        nper: Número total de periodos.
        pmt_: Pago por periodo.
        pv: Valor presente.
        fv: Valor futuro (por defecto 0).
        type_: Tipo de pago (0=final, 1=inicio).
        guess: Estimación inicial (por defecto 0.1).

    Returns
        float: Tasa de interés por periodo.

    Usage Example
        >>> rate(60, -1000, 50000)
        0.015

    Cost
        O(n) iteraciones de Newton-Raphson
    """
    return _core_rate(nper, pmt_, pv, fv, type_, guess)

SLN(cost: float, salvage: float, life: float) -> float

Description Depreciación lineal de un bien durante único periodo.

Args cost: Costo inicial del bien. salvage: Valor al término de vida útil. life: Duración de vida útil.

Returns float: Depreciación lineal.

Usage Example >>> sln(10000, 1000, 5) 1800.0

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
def SLN(cost: float, salvage: float, life: float) -> float:
    """
    Description
        Depreciación lineal de un bien durante único periodo.

    Args
        cost: Costo inicial del bien.
        salvage: Valor al término de vida útil.
        life: Duración de vida útil.

    Returns
        float: Depreciación lineal.

    Usage Example
        >>> sln(10000, 1000, 5)
        1800.0

    Cost
        O(1)
    """
    return _core_sln(cost, salvage, life)

SYD(cost: float, salvage: float, life: float, period: float) -> float

Description Depreciación por suma de dígitos de años para un periodo.

Args cost: Costo inicial del bien. salvage: Valor al término de vida útil. life: Duración de vida útil. period: Periodo para el cual se calcula.

Returns float: Depreciación para el periodo.

Usage Example >>> syd(10000, 1000, 5, 1) 3000.0

Cost O(1)

Source code in shortfx/fxVBA/financial_functions.py 
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
def SYD(cost: float, salvage: float, life: float, period: float) -> float:
    """
    Description
        Depreciación por suma de dígitos de años para un periodo.

    Args
        cost: Costo inicial del bien.
        salvage: Valor al término de vida útil.
        life: Duración de vida útil.
        period: Periodo para el cual se calcula.

    Returns
        float: Depreciación para el periodo.

    Usage Example
        >>> syd(10000, 1000, 5, 1)
        3000.0

    Cost
        O(1)
    """
    return _core_syd(cost, salvage, int(life), int(period))